WA Templates

Endpoint

WhatsApp message template management

List WhatsApp message templates

GET

https://api-chat.bara.my.id

/api/wa-templates

List WhatsApp message templates › query Parameters

status

string · enum

Enum values:

APPROVED

PENDING

REJECTED

PAUSED

DISABLED

category

string · enum

Enum values:

MARKETING

UTILITY

AUTHENTICATION

waba_id

string

Filter by WhatsApp Business Account ID

List WhatsApp message templates › Responses

List of templates

object[]

id

string · uuid · required

waba_id

string · required

WhatsApp Business Account ID

name

string · required

language

string · required

BCP-47 language code (e.g. id, en_US)

category

string · enum · required

Enum values:

MARKETING

UTILITY

AUTHENTICATION

status

string · enum · required

Enum values:

APPROVED

PENDING

REJECTED

PAUSED

DISABLED

components

required

Meta template components array (HEADER, BODY, FOOTER, BUTTONS)

created_at

string · date-time · required

updated_at

string · date-time · required

meta_template_id

string

Template ID assigned by Meta

header_media_url

string

Public MinIO URL for the header media (IMAGE/VIDEO/DOCUMENT)

Create a WhatsApp message template

POST

https://api-chat.bara.my.id

/api/wa-templates

Submits the template to Meta for review and stores it locally.

Create a WhatsApp message template › Request Body

name

string · required

Lowercase letters, numbers, and underscores only. Max 512 chars.

components

required

Meta template components array

language

string

Default: id

category

string · enum

Enum values:

MARKETING

UTILITY

AUTHENTICATION

Default: MARKETING

integration_account_id

string · uuid

Use specific WABA account. Falls back to META_WABA_ID env var.

Create a WhatsApp message template › Responses

Template created and submitted to Meta

id

string · uuid · required

waba_id

string · required

WhatsApp Business Account ID

name

string · required

language

string · required

BCP-47 language code (e.g. id, en_US)

category

string · enum · required

Enum values:

MARKETING

UTILITY

AUTHENTICATION

status

string · enum · required

Enum values:

APPROVED

PENDING

REJECTED

PAUSED

DISABLED

components

required

Meta template components array (HEADER, BODY, FOOTER, BUTTONS)

created_at

string · date-time · required

updated_at

string · date-time · required

meta_template_id

string

Template ID assigned by Meta

header_media_url

string

Public MinIO URL for the header media (IMAGE/VIDEO/DOCUMENT)

POST/api/wa-templates

curl --request POST \
  --url https://api-chat.bara.my.id/api/wa-templates \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "name",
  "language": "id",
  "category": "MARKETING",
  "components": {},
  "integration_account_id": "00000000-0000-0000-0000-000000000000"
}
'

shell

Example Request Body

{
  "name": "name",
  "language": "id",
  "category": "MARKETING",
  "components": {},
  "integration_account_id": "00000000-0000-0000-0000-000000000000"
}

json

Example Responses

{
  "id": "00000000-0000-0000-0000-000000000000",
  "meta_template_id": "meta_template_id",
  "waba_id": "waba_id",
  "name": "name",
  "language": "language",
  "category": "MARKETING",
  "status": "APPROVED",
  "components": {},
  "header_media_url": "header_media_url",
  "created_at": "2024-08-25T15:00:00Z",
  "updated_at": "2024-08-25T15:00:00Z"
}

json

application/json

Sync templates from Meta

POST

https://api-chat.bara.my.id

/api/wa-templates/sync

Downloads all templates from the WABA and upserts them locally. Optionally re-hosts header media to MinIO for persistent public URLs. Optionally scope to a specific integration account via query param.

Sync templates from Meta › query Parameters

integration_account_id

string · uuid

Use specific WABA account. Falls back to META_WABA_ID env var.

Sync templates from Meta › Responses

Sync result

message

string

total_from_meta

integer

synced

integer

errors

integer

Get a WhatsApp template by ID

GET

https://api-chat.bara.my.id

/api/wa-templates/{id}

Get a WhatsApp template by ID › path Parameters

id

string · uuid · required

Get a WhatsApp template by ID › Responses

Template details

id

string · uuid · required

waba_id

string · required

WhatsApp Business Account ID

name

string · required

language

string · required

BCP-47 language code (e.g. id, en_US)

category

string · enum · required

Enum values:

MARKETING

UTILITY

AUTHENTICATION

status

string · enum · required

Enum values:

APPROVED

PENDING

REJECTED

PAUSED

DISABLED

components

required

Meta template components array (HEADER, BODY, FOOTER, BUTTONS)

created_at

string · date-time · required

updated_at

string · date-time · required

meta_template_id

string

Template ID assigned by Meta

header_media_url

string

Public MinIO URL for the header media (IMAGE/VIDEO/DOCUMENT)

Delete a WhatsApp template (local only)

DELETE

https://api-chat.bara.my.id

/api/wa-templates/{id}

Deletes locally. Does not delete from Meta. Fails if any campaign references this template.

Delete a WhatsApp template (local only) › path Parameters

id

string · uuid · required

Delete a WhatsApp template (local only) › Responses

Template deleted

message

string

Update template header media URL

PATCH

https://api-chat.bara.my.id

/api/wa-templates/{id}/header-media

Sets or replaces the header_media_url for a template. Use this when the automatic re-hosting during sync fails (e.g. expired scontent URL).

Update template header media URL › path Parameters

id

string · uuid · required

Update template header media URL › Request Body

header_media_url

string · required

Publicly accessible URL for the header media

Update template header media URL › Responses

Header media URL updated

id

string · uuid · required

waba_id

string · required

WhatsApp Business Account ID

name

string · required

language

string · required

BCP-47 language code (e.g. id, en_US)

category

string · enum · required

Enum values:

MARKETING

UTILITY

AUTHENTICATION

status

string · enum · required

Enum values:

APPROVED

PENDING

REJECTED

PAUSED

DISABLED

components

required

Meta template components array (HEADER, BODY, FOOTER, BUTTONS)

created_at

string · date-time · required

updated_at

string · date-time · required

meta_template_id

string

Template ID assigned by Meta

header_media_url

string

Public MinIO URL for the header media (IMAGE/VIDEO/DOCUMENT)

Activity Logs Webhooks

OmniStream CRM API

WA Templates

Endpoint

WhatsApp message template management

List WhatsApp message templates

GET

https://api-chat.bara.my.id

/api/wa-templates

List WhatsApp message templates › query Parameters

status

string · enum

Enum values:

APPROVED

PENDING

REJECTED

PAUSED

DISABLED

category

string · enum

Enum values:

MARKETING

UTILITY

AUTHENTICATION

waba_id

string

Filter by WhatsApp Business Account ID

List WhatsApp message templates › Responses

List of templates

object[]

id

string · uuid · required

waba_id

string · required

WhatsApp Business Account ID

name

string · required

language

string · required

BCP-47 language code (e.g. id, en_US)

category

string · enum · required

Enum values:

MARKETING

UTILITY

AUTHENTICATION

status

string · enum · required

Enum values:

APPROVED

PENDING

REJECTED

PAUSED

DISABLED

components

required

Meta template components array (HEADER, BODY, FOOTER, BUTTONS)

created_at

string · date-time · required

updated_at

string · date-time · required

meta_template_id

string

Template ID assigned by Meta

header_media_url

string

Public MinIO URL for the header media (IMAGE/VIDEO/DOCUMENT)

Create a WhatsApp message template

POST

https://api-chat.bara.my.id

/api/wa-templates

Submits the template to Meta for review and stores it locally.

Create a WhatsApp message template › Request Body

name

string · required

Lowercase letters, numbers, and underscores only. Max 512 chars.

components

required

Meta template components array

language

string

Default: id

category

string · enum

Enum values:

MARKETING

UTILITY

AUTHENTICATION

Default: MARKETING

integration_account_id

string · uuid

Use specific WABA account. Falls back to META_WABA_ID env var.

Create a WhatsApp message template › Responses

Template created and submitted to Meta

id

string · uuid · required

waba_id

string · required

WhatsApp Business Account ID

name

string · required

language

string · required

BCP-47 language code (e.g. id, en_US)

category

string · enum · required

Enum values:

MARKETING

UTILITY

AUTHENTICATION

status

string · enum · required

Enum values:

APPROVED

PENDING

REJECTED

PAUSED

DISABLED

components

required

Meta template components array (HEADER, BODY, FOOTER, BUTTONS)

created_at

string · date-time · required

updated_at

string · date-time · required

meta_template_id

string

Template ID assigned by Meta

header_media_url

string

Public MinIO URL for the header media (IMAGE/VIDEO/DOCUMENT)

POST/api/wa-templates

curl --request POST \
  --url https://api-chat.bara.my.id/api/wa-templates \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "name",
  "language": "id",
  "category": "MARKETING",
  "components": {},
  "integration_account_id": "00000000-0000-0000-0000-000000000000"
}
'

shell

Example Request Body

{
  "name": "name",
  "language": "id",
  "category": "MARKETING",
  "components": {},
  "integration_account_id": "00000000-0000-0000-0000-000000000000"
}

json

Example Responses

{
  "id": "00000000-0000-0000-0000-000000000000",
  "meta_template_id": "meta_template_id",
  "waba_id": "waba_id",
  "name": "name",
  "language": "language",
  "category": "MARKETING",
  "status": "APPROVED",
  "components": {},
  "header_media_url": "header_media_url",
  "created_at": "2024-08-25T15:00:00Z",
  "updated_at": "2024-08-25T15:00:00Z"
}

json

application/json

Sync templates from Meta

POST

https://api-chat.bara.my.id

/api/wa-templates/sync

Sync templates from Meta › query Parameters

integration_account_id

string · uuid

Use specific WABA account. Falls back to META_WABA_ID env var.

Sync templates from Meta › Responses

Sync result

message

string

total_from_meta

integer

synced

integer

errors

integer

Get a WhatsApp template by ID

GET

https://api-chat.bara.my.id

/api/wa-templates/{id}

Get a WhatsApp template by ID › path Parameters

id

string · uuid · required

Get a WhatsApp template by ID › Responses

Template details

id

string · uuid · required

waba_id

string · required

WhatsApp Business Account ID

name

string · required

language

string · required

BCP-47 language code (e.g. id, en_US)

category

string · enum · required

Enum values:

MARKETING

UTILITY

AUTHENTICATION

status

string · enum · required

Enum values:

APPROVED

PENDING

REJECTED

PAUSED

DISABLED

components

required

Meta template components array (HEADER, BODY, FOOTER, BUTTONS)

created_at

string · date-time · required

updated_at

string · date-time · required

meta_template_id

string

Template ID assigned by Meta

header_media_url

string

Public MinIO URL for the header media (IMAGE/VIDEO/DOCUMENT)

Delete a WhatsApp template (local only)

DELETE

https://api-chat.bara.my.id

/api/wa-templates/{id}

Deletes locally. Does not delete from Meta. Fails if any campaign references this template.

Delete a WhatsApp template (local only) › path Parameters

id

string · uuid · required

Delete a WhatsApp template (local only) › Responses

Template deleted

message

string

Update template header media URL

PATCH

https://api-chat.bara.my.id

/api/wa-templates/{id}/header-media

Sets or replaces the header_media_url for a template. Use this when the automatic re-hosting during sync fails (e.g. expired scontent URL).

Update template header media URL › path Parameters

id

string · uuid · required

Update template header media URL › Request Body

header_media_url

string · required

Publicly accessible URL for the header media

Update template header media URL › Responses

Header media URL updated

id

string · uuid · required

waba_id

string · required

WhatsApp Business Account ID

name

string · required

language

string · required

BCP-47 language code (e.g. id, en_US)

category

string · enum · required

Enum values:

MARKETING

UTILITY

AUTHENTICATION

status

string · enum · required

Enum values:

APPROVED

PENDING

REJECTED

PAUSED

DISABLED

components

required

Meta template components array (HEADER, BODY, FOOTER, BUTTONS)

created_at

string · date-time · required

updated_at

string · date-time · required

meta_template_id

string

Template ID assigned by Meta

header_media_url

string

Public MinIO URL for the header media (IMAGE/VIDEO/DOCUMENT)

Activity Logs Webhooks