WhatsApp Templates API

1. Overview

Public Developer API for Meta template lifecycle on Cloud WhatsApp accounts. Same Meta engine as the Washeej dashboard. Access requires explicit template scopes; Device/QR management is rejected. Provider Meta delete stays deferred.

What this API does

  • Validate template payloads locally (provider_calls=0).
  • Create/submit text UTILITY/MARKETING templates to Meta.
  • List/detail with canonical + provider status truth.
  • Sync from WABA; edit rejected templates; delete under policy.
  • Send approved templates (compatible with existing POST /v1/templates/send).
  • Receive Meta status updates and deliver signed external webhooks.

Deferred: media headers, authentication/OTP contract, carousel, catalog, flows.

Availability: code is deployed and documented. Global lifecycle enablement remains disabled (FEATURE_DEVELOPER_TEMPLATE_LIFECYCLE_V1=false unless a canary assignment is granted). Internal Meta canary qualification is pending — do not assume Meta E2E passed or that the API is open to all integrations.

Public OpenAPI: /api-v1-documentation/openapi/templates.yaml. Agents: Markdown · llms.txt.