Skip to main content
GET
List message templates
List the message templates registered on your account. A template holds the wording of a message, the channels it can be delivered over and the countries it is registered in, so a reseller can register a template per sub-customer. Reference one from the template_id field of a Send a Message request. Each entry carries its approval status and a region_statuses map telling you, country by country, whether a sender registration is needed and how far it has got. The list is paginated. Use limit to size a page, up to 200, and pass the next_cursor of a response back as cursor to read the next one. A response without next_cursor is the last page.
Access to the management API is opt-in. Contact our support team to enable it on your account.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit
integer
default:50

Maximum number of templates to return per page

Required range: 1 <= x <= 200
cursor
string

Pagination cursor from the previous response

Response

OK

templates
object[]
required

The message templates registered on your account.

next_cursor
string

Pagination cursor for the next page of results. Omitted if there are no more pages.

Example:

"EjRWeJCrEs1FZ4kKsSzeRX0fKjtMXW5_gJGis8TV5vcAAAAAZ3SFgA"