Template Operations | WhatsApp

send

Sends a pre-approved message template. Identical call to message/send-template — a duplicate route for template-centric workflows.

Field	Required	Description
`to`	✓ Yes	Recipient phone number.
`templateName`	✓ Yes	Approved template name.
`languageCode`	✓ Yes	Template language/locale code.
`componentsJson`	No	JSON array of component parameters.

list

Lists message templates for a business account.

Field	Required	Description
`businessAccountId`	✓ Yes	WhatsApp Business Account (WABA) ID.
`limit`	No	Page size.
`cursor`	No	Pagination cursor from a previous response.

get

Fetches a single template by ID.

Field	Required	Description
`templateId`	✓ Yes	Template ID.

create

Submits a new template for Meta review/approval.

Field	Required	Description
`businessAccountId`	✓ Yes	WABA ID the template is created under.
`name`	✓ Yes	Template name (unique per WABA/language).
`category`	✓ Yes	Template category, e.g. `MARKETING`, `UTILITY`, `AUTHENTICATION`.
`language`	✓ Yes	Template language/locale code.
`componentsJson`	No	JSON array describing header/body/footer/buttons.

update

Updates an existing template's components (subject to re-review by Meta).

Field	Required	Description
`templateId`	✓ Yes	Template ID to update.
`componentsJson`	No	New JSON array of components.

delete

Deletes a template by name.

Field	Required	Description
`businessAccountId`	✓ Yes	WABA ID the template belongs to.
`templateName`	✓ Yes	Name of the template to delete.

Templates require Meta approval: create submits a template for review — it isn't immediately sendable. Use get or list to poll approval status before calling send.

businessAccountId vs. phoneNumberId: template management operations (list, create, update, delete) act on the WABA via businessAccountId and only need accessToken — no phoneNumberId. Sending a template (send) is a message and needs both accessToken and phoneNumberId.