All pages

API reference

List a WhatsApp number's templates

GET /v1/whatsapp/senders/{sender_id}/templates

View as Markdown

The message templates Meta has approved for this number's business account: the ones a conversation can be started with. Write and approve them in WhatsApp Manager. Needs whatsapp:write.

Parameters

Name In Type Required Description
sender_id path string (uuid) Yes

Answer

200 with WhatsappTemplateList.

Errors

Every error is a problem document with a stable code.

Status When
401 The key is missing, mistyped, unknown, revoked or expired.
403 The key lacks a permission, a live key was sent from a browser, or the organization is frozen and the request would change something.
404 This key reaches no such WhatsApp number.
409 The connection has no business account id or access token.
422 Validation Error
429 Too many requests for this key or its organization; see Retry-After.
500 Something went wrong on our side. Quote the request_id to support.
501 This deployment does not run WhatsApp.

Examples

List a WhatsApp number's templates
#!/bin/sh
# List a WhatsApp number's templates. Write and approve them in WhatsApp Manager.
curl -sS --fail-with-body -X GET "https://api.aigently.ai/v1/whatsapp/senders/7d9f1b3d-5f7b-4d9f-c1b3-d5f7b9dbfd1f/templates" \
  -H "Authorization: Bearer $AIGENTLY_API_KEY"

Try it

Sends this request to the API from your browser, with a test key. Nothing it does rings a phone.