Skip to main content
POST
/
v1
/
businesses
/
{businessId}
/
get
/
templates
Get Templates
curl --request POST \
  --url https://api.example.com/v1/businesses/{businessId}/get/templates
Retrieve all WhatsApp templates associated with your business account. Templates with the same name but different language translations are grouped together as a template group. Use this endpoint to check approval status after submitting a new template.

​
Endpoint

POST https://api.connectly.ai/v1/businesses/{businessId}/get/templates
This endpoint uses POST with no request body.

​
Response

Returns a list of template groups under entity.templateGroups. Each group contains one or more language variants. Template status values:
StatusDescription
MESSAGE_TEMPLATE_STATUS_PENDINGSubmitted to Meta and awaiting review.
MESSAGE_TEMPLATE_STATUS_APPROVEDApproved by Meta — ready to use.
MESSAGE_TEMPLATE_STATUS_REJECTEDRejected by Meta. Check rejectionReason for details.

​
Example

curl -X POST "https://api.connectly.ai/v1/businesses/{businessId}/get/templates" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "entity": {
    "templateGroups": [
      {
        "id": "order_confirmation",
        "name": "order_confirmation",
        "category": "ACCOUNT_UPDATE",
        "templates": [
          {
            "id": "651213231234567",
            "language": { "code": "en" },
            "status": "MESSAGE_TEMPLATE_STATUS_REJECTED",
            "createdAt": "2022-03-09T23:07:01Z",
            "updatedAt": "2022-03-09T23:07:01Z",
            "rejectionReason": "INVALID_FORMAT",
            "templateComponents": [
              {
                "header": {
                  "media": {
                    "type": "TYPE_IMAGE",
                    "example": ["https://example.com/header.png"]
                  }
                }
              },
              {
                "body": {
                  "text": {
                    "text": "Welcome to Connectly!",
                    "example": []
                  }
                }
              },
              {
                "footer": {
                  "text": { "text": "Connectly.ai", "example": [] }
                }
              },
              { "button": { "quickReply": { "text": "Continue" } } },
              { "button": { "quickReply": { "text": "Stop" } } }
            ],
            "externalTemplate": {
              "whatsapp": {
                "id": "651213231234567",
                "name": "order_confirmation",
                "language": "en",
                "status": "REJECTED",
                "rejectedReason": "INVALID_FORMAT",
                "qualityScore": { "score": "UNKNOWN" }
              }
            }
          }
        ]
      }
    ]
  }
}
The externalTemplate.whatsapp object contains the raw template data as returned directly by Meta, alongside Connectly’s own representation in templateComponents. Use templateComponents for the Connectly-native format.