Skip to content
PaalChat Docs

Create template

.md
POST
https://whatsapp.paaltech.org/api/v1/businesses/{external_id}/whatsapp/templates

Token ability: templates.manage ยท Authentication

Submits a new template to Meta for review on the business's WhatsApp account and mirrors it (usually PENDING). Meta's decision arrives as a template.status callback. components are Meta's template components, passed through as they are; category is marketing, utility or authentication. With several WhatsApp accounts, pass waba_id. Meta allows 100 new templates per account per hour.

Path parameters

external_id string required

Your own ID for the business (Multi-SKUUL - the tenant ID).

Max 191 characters. Pattern ^[A-Za-z0-9._:-]+$.

Body parameters

name string required

Max 512 characters. Pattern ^[a-z0-9_]+$.

language string required

Example en_US.

category string required

One of: marketing, utility, authentication.

parameter_format string | null

One of: named, positional, ``.

components array of objects required

Meta's template components (HEADER, BODY, FOOTER, BUTTONS), with examples.

Max 10 items.

waba_id string | null

Needed only when the business has several WhatsApp accounts.

Responses

201

Submitted to Meta and mirrored.

401

unauthenticated - missing, invalid, revoked or expired token

403

missing_ability, product_suspended or product_token_required

404

not_found - not yours, or does not exist

409

business_suspended - the business is suspended on PaalChat.

422

validation_failed, waba_required (several accounts, no waba_id) or template_rejected (Meta refused it - the message says why).

429

rate_limited - over 300 requests/minute for this product

503

meta_unavailable - Meta did not answer normally. Retry later.

Errors always look like {"error": {"code", "message"}} - see Errors and status codes.