Templates

API reference descriptions are provided in English to preserve the exact published contract.

GETList templatestemplates.list
POSTCreate a template drafttemplates.create
GETBrowse the versioned Meta Template Library catalogtemplates.library.list
POSTReconcile the complete local template projection with Metatemplates.reconcile
GETFetch a templatetemplates.retrieve
PATCHEdit a draft or provider-backed templatetemplates.update
DELETEDelete a template by nametemplates.delete
POSTRecord an approved-template category appeal submitted through Meta Business Supporttemplates.appeal
POSTDuplicate a template as a new draft while retaining its origintemplates.duplicate
GETFetch template category, version, and appeal historytemplates.history.list
GETRead Toutye's staff review of a template on a Toutye-managed numbertemplates.managedReview.list
GETRead exact accepted-template retained performancetemplates.performance.list
POSTSubmit a template for reviewtemplates.submit

List templates

GET/v1/accounts/{AC}/templates

templates.listSDK operation getV1AccountsByAcTemplates

List message templates with their review status and quality.

Required scope: templates:read.Paginated

Parameters

limitinteger (1–100)query
cursorstring (max 2048 chars)query
wabaSidstring (WB… SID)query
Filter by WABA SID
namestring (max 512 chars)query
languagestring (max 16 chars)query
statusstring (max 32 chars)query
categorystring (max 16 chars)query
qualityScorestring (max 16 chars)query
updatedAfterstring (date-time)query

GET /v1/accounts/{AC}/templates

curl "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/templates" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

Create a template draft

POST/v1/accounts/{AC}/templates

templates.createSDK operation postV1AccountsByAcTemplates

Create a template draft. Nothing is sent to Meta until you submit it for review.

Required scope: templates:write.Idempotency-Key required

Request body

categoryenumRequired
MARKETINGUTILITYAUTHENTICATION
languagestring (max 16 chars)Required
namestring (max 512 chars)Required
parameterFormatenumRequired
NAMEDPOSITIONAL
codeExpirationMinutesinteger (1–90)
componentsobject[]
headerMediaHandlestring (pattern ^[0-9]+:\S+$, max 2048 chars)
Handle returned by POST /media/uploads for a media template header.
libraryTemplateNamestring (max 256 chars)
messageSendTtlSecondsinteger (30–2592000)
sourceenum
custommeta_library
wabaSidstring (WB… SID)
WABA SID; required when the account has multiple WABAs

POST /v1/accounts/{AC}/templates

curl -X POST "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/templates" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "category": "MARKETING",
  "language": "string",
  "name": "string",
  "parameterFormat": "NAMED"
}'

Responses

Browse the versioned Meta Template Library catalog

GET/v1/accounts/{AC}/templates/library

templates.library.listSDK operation getV1AccountsByAcTemplatesLibrary

Required scope: templates:read.Paginated

Parameters

qstring (max 128 chars)query
categoryenumquery
MARKETINGUTILITYAUTHENTICATION
languagestring (max 16 chars)query
limitinteger (1–100)query
cursorstring (max 2048 chars)query

GET /v1/accounts/{AC}/templates/library

curl "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/templates/library" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

Reconcile the complete local template projection with Meta

POST/v1/accounts/{AC}/templates/reconcile

templates.reconcileSDK operation postV1AccountsByAcTemplatesReconcile

Required scope: templates:write.Idempotency-Key required

Parameters

wabaSidstring (WB… SID)query

POST /v1/accounts/{AC}/templates/reconcile

curl -X POST "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/templates/reconcile" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)"

Responses

Fetch a template

GET/v1/accounts/{AC}/templates/{TM}

templates.retrieveSDK operation getV1AccountsByAcTemplatesByTm

Fetch one template with its components, status and rejection reason, if any.

Required scope: templates:read.

Parameters

TMstring (TM… SID)Required
Template SID

GET /v1/accounts/{AC}/templates/{TM}

curl "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/templates/TM..." \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

Edit a draft or provider-backed template

PATCH/v1/accounts/{AC}/templates/{TM}

templates.updateSDK operation patchV1AccountsByAcTemplatesByTm

Edit a draft, or a template already with Meta where Meta allows the change.

Required scope: templates:write.Idempotency-Key required

Parameters

TMstring (TM… SID)Required
Template SID

Request body

categoryenum
MARKETINGUTILITYAUTHENTICATION
codeExpirationMinutesinteger (1–90)
componentsobject[]
headerMediaHandlestring (pattern ^[0-9]+:\S+$, max 2048 chars)
Handle returned by POST /media/uploads for a media template header.
messageSendTtlSecondsinteger (30–2592000)

PATCH /v1/accounts/{AC}/templates/{TM}

curl -X PATCH "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/templates/TM..." \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)"

Responses

Delete a template by name

DELETE/v1/accounts/{AC}/templates/{TM}

templates.deleteSDK operation deleteV1AccountsByAcTemplatesByTm

Delete a template. Meta deletes every language of the same name, and the name cannot be reused for 30 days.

Required scope: templates:write.

Parameters

TMstring (TM… SID)Required
Template SID
languagestring (max 16 chars)query

DELETE /v1/accounts/{AC}/templates/{TM}

curl -X DELETE "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/templates/TM..." \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

Record an approved-template category appeal submitted through Meta Business Support

POST/v1/accounts/{AC}/templates/{TM}/appeal

templates.appealSDK operation postV1AccountsByAcTemplatesByTmAppeal

Records the confirmed external case for the latest Meta category change and projects IN_APPEAL.

Required scope: templates:write.Idempotency-Key required

Parameters

TMstring (TM… SID)Required
Template SID

Request body

confirmedSubmittedToMetatrueRequired
notestring (max 2000 chars)Required
supportCaseReferencestring (max 256 chars)Required

POST /v1/accounts/{AC}/templates/{TM}/appeal

curl -X POST "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/templates/TM.../appeal" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "confirmedSubmittedToMeta": "string",
  "note": "string",
  "supportCaseReference": "string"
}'

Responses

Duplicate a template as a new draft while retaining its origin

POST/v1/accounts/{AC}/templates/{TM}/duplicate

templates.duplicateSDK operation postV1AccountsByAcTemplatesByTmDuplicate

Required scope: templates:write.Idempotency-Key required

Parameters

TMstring (TM… SID)Required
Template SID

Request body

namestring (max 512 chars)Required
languagestring (max 16 chars)

POST /v1/accounts/{AC}/templates/{TM}/duplicate

curl -X POST "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/templates/TM.../duplicate" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "string"
}'

Responses

Fetch template category, version, and appeal history

GET/v1/accounts/{AC}/templates/{TM}/history

templates.history.listSDK operation getV1AccountsByAcTemplatesByTmHistory

Required scope: templates:read.Paginated

Parameters

TMstring (TM… SID)Required
Template SID
limitinteger (1–100)query
cursorstring (max 2048 chars)query
appealCursorstring (max 2048 chars)query
observationCursorstring (max 2048 chars)query

GET /v1/accounts/{AC}/templates/{TM}/history

curl "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/templates/TM.../history" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

Read Toutye's staff review of a template on a Toutye-managed number

GET/v1/accounts/{AC}/templates/{TM}/managed-review

templates.managedReview.listSDK operation getV1AccountsByAcTemplatesByTmManagedReview

Managed templates are approved by Toutye staff before they are submitted to Meta. Returns the latest review.

Required scope: templates:read.

Parameters

TMstring (TM… SID)Required
Template SID

GET /v1/accounts/{AC}/templates/{TM}/managed-review

curl "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/templates/TM.../managed-review" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

Read exact accepted-template retained performance

GET/v1/accounts/{AC}/templates/{TM}/performance

templates.performance.listSDK operation getV1AccountsByAcTemplatesByTmPerformance

Required scope: templates:read.Additionally, every one of these scopes is required: templates:read, analytics:read.

Parameters

TMstring (TM… SID)Required
fromstring (date-time)query
tostring (date-time)query

GET /v1/accounts/{AC}/templates/{TM}/performance

curl "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/templates/TM.../performance" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21"

Responses

Submit a template for review

POST/v1/accounts/{AC}/templates/{TM}/submit

templates.submitSDK operation postV1AccountsByAcTemplatesByTmSubmit

Submit a draft to Meta for review. The result arrives as a template.* webhook event.

Required scope: templates:write.Idempotency-Key required

Parameters

TMstring (TM… SID)Required
Template SID

POST /v1/accounts/{AC}/templates/{TM}/submit

curl -X POST "https://api.staging.toutye.com/v1/accounts/$TOUTYE_ACCOUNT_SID/templates/TM.../submit" \
  -H "Authorization: Bearer $TOUTYE_API_KEY" \
  -H "Toutye-Version: 2026-08-21" \
  -H "Idempotency-Key: $(uuidgen)"

Responses