Skip to main content
Retrieve all WhatsApp Message Templates in your project. Results are returned in reverse-chronological order (most recently created first) and support cursor-based pagination for iterating through large collections.

Endpoint

Authentication

Path Parameters

string
required
Your Convo project ID.

Query Parameters

number
The maximum number of templates to return per page. Must be between 1 and 100. Defaults to 10.
string
A pagination cursor. When provided, returns the page of results immediately before this cursor. Use the paging.cursors.before value from a previous response.
string
A pagination cursor. When provided, returns the page of results immediately after this cursor. Use the paging.cursors.after value from a previous response to fetch the next page.

Request Example

To fetch the next page using a cursor:

Response

A successful request returns 200 OK with a data array of template objects and a paging object for cursor navigation.
Templates with status: "REJECTED" include a rejected_reason field explaining why WhatsApp declined the template. Address the stated issues before resubmitting.

Template Status Values

Error Responses