TagMangoTagMango Docs
Broadcasts

Discover WhatsApp broadcast templates

GET
/api/v1/external/broadcasts/whatsapp/templates

Returns approved templates from one connected AiSensy or Zaptick provider when provider is supplied. Omit it to combine both connected providers; each template then includes its source provider. A provider that fails is omitted, so an omitted-provider request can return a partial or empty catalogue with HTTP 200. Results are not sorted, deduplicated, or paginated; do not rely on their order.

To create a WhatsApp broadcast, pass templateName as channel.template.name and the template’s provider as channel.template.provider. Creation revalidates the selected provider credentials, approval status, supported format, and bindings.

External access policy

An API key and an authorized white-label host are required. Both tier and plan requirements are enforced.

These requirements apply to the white-label creator for backend-to-backend access. TagMango platform access is not supported.

  • Plans: Unrestricted.

  • Tiers: Unrestricted.

AuthorizationBearer <token>

In: header

Query Parameters

provider?string

Connected AiSensy or Zaptick provider to fetch. Omit to combine both supported connected providers.

Value in"aisensy" | "zaptick"

Header Parameters

x-whitelabel-host*string

Host name of the dashboard, ex: mydomain.tagmango.com

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api-prod-new.tagmango.com/api/v1/external/broadcasts/whatsapp/templates" \  -H "x-whitelabel-host: string"
{
  "templates": [
    {
      "templateName": "order_update",
      "bodyText": "Hello {{1}}, your order {{2}} is ready.",
      "variables": [
        "1",
        "2"
      ],
      "status": "approved",
      "category": "marketing",
      "assetType": "image",
      "contentAsset": "https://cdn.example.com/template-header.png",
      "displayName": "Order update",
      "templateFor": "purchase",
      "approvedAt": "2030-09-22T12:00:00.000Z",
      "staticVariables": [
        {
          "name": "supportName",
          "examples": null
        }
      ],
      "buttons": [
        {
          "type": "URL",
          "text": "View details",
          "url": "https://example.com/orders/{{1}}"
        }
      ],
      "whatsappGivenIdentifier": "template_12345",
      "provider": "zaptick"
    }
  ],
  "configType": "custom",
  "provider": "zaptick"
}
{
  "code": 400,
  "type": "Bad Request",
  "statusMessage": "BAD_REQUEST",
  "errorCode": "BROADCAST_PROVIDER_NOT_CONNECTED",
  "message": "The requested AiSensy or Zaptick provider is not connected for this creator.",
  "result": "The requested AiSensy or Zaptick provider is not connected for this creator.",
  "success": false
}
{
  "code": 401,
  "type": "Unauthorized",
  "statusMessage": "UNAUTHORIZED",
  "message": "Invalid token",
  "result": "Invalid token",
  "success": false
}
{
  "code": 403,
  "type": "Forbidden",
  "statusMessage": "FORBIDDEN",
  "errorCode": "WORKSHOP_MANGO_FORBIDDEN",
  "message": "You can not access this api with a TagMango account, only available for whitelabel hosts",
  "result": "You can not access this api with a TagMango account, only available for whitelabel hosts",
  "success": false
}
{
  "code": 429,
  "type": "Too Many Requests",
  "statusMessage": "TOO_MANY_REQUESTS",
  "message": "Request limit exceeded. try after 10 seconds",
  "result": "Request limit exceeded. try after 10 seconds",
  "success": false
}
{
  "code": 500,
  "type": "UnknownError",
  "statusMessage": "INTERNAL_SERVER_ERROR",
  "errorCode": "BROADCAST_TEMPLATE_DISCOVERY_FAILED",
  "message": "The connected WhatsApp provider could not return the creator’s approved templates.",
  "result": "The connected WhatsApp provider could not return the creator’s approved templates.",
  "success": false
}