List messaging templates | Nexiom Connect

GET/v1/messaging/templates

Use it to find the template to send and the values a send needs. Templates are created, submitted, and changed in the dashboard, under Messaging → Templates; see Message templates.

Authorization

Bearer token

Authorizationrequiredheader: Send your API key as Bearer YOUR_API_KEY.
Permissionwhatsapp.send: A key with whatsapp.full_access can also list templates. WhatsApp must be turned on for your organization.

Query parameters

statusstring

See Drafts and submitted templates.

One of"draft""submitted""archived"

content_typestring

See Content types.

One of"text""media""quick_reply""call_to_action""card""authentication""carousel"

categorystring

One of"marketing""utility""authentication"

languagestring

Only templates in this exact language, such as en or en_US.

channelstring

Only templates whose content fits this channel.

One of"whatsapp""sms"

querystring

Part of the template name, 1 to 200 characters. Case doesn't matter.

Unknown parameters are refused with 400.

Response

application/json200 OK

Templates are under data.items, ordered by name, then language. The list isn't paginated. Deleted templates are never listed.

Each item is a template object. A template can be sent on WhatsApp when channel_status.whatsapp.ready is true, from a number whose WhatsApp account has an approved approval.

curl "https://api-connect.nxiom.com/api/v1/messaging/templates?status=submitted&channel=whatsapp" \
  -H "Authorization: Bearer $NEXIOM_API_KEY"

Set NEXIOM_API_KEY in your environment.

{
  "message": "Templates fetched",
  "data": {
    "items": [
      {
        "id": "mtp_example",
        "name": "order_confirmation",
        "language": "en",
        "category": "utility",
        "content_type": "quick_reply",
        "status": "submitted",
        "source": "library",
        "library_key": "order_confirmation",
        "content": {
          "header": null,
          "body": {
            "text": "Hello {{1}}, we received your order {{2}} for {{3}}. Please confirm it so we can prepare it for delivery.",
            "examples": { "1": "Amina", "2": "A-1234", "3": "4,500 DZD" }
          },
          "footer": null,
          "buttons": [
            { "type": "quick_reply", "text": "Confirm order" },
            { "type": "quick_reply", "text": "Cancel order" }
          ],
          "authentication": null,
          "cards": []
        },
        "variables": {
          "header": [],
          "body": ["1", "2", "3"],
          "header_media": null,
          "buttons": [
            { "index": 0, "type": "quick_reply", "required": false },
            { "index": 1, "type": "quick_reply", "required": false }
          ],
          "code": false,
          "cards": []
        },
        "channels": ["whatsapp"],
        "channel_status": {
          "whatsapp": {
            "ready": true,
            "approvals": [
              {
                "whatsapp_template_id": "wat_example",
                "account_id": "wac_example",
                "waba_id": "100000000000001",
                "status": "active",
                "approval_status": "approved",
                "category": "utility",
                "rejection_reason": null,
                "unsupported_reason": null,
                "matches_content": true,
                "submitted_at": "2026-10-17T08:00:00.000Z",
                "last_synced_at": "2026-10-17T08:05:00.000Z"
              }
            ]
          },
          "sms": { "ready": false }
        },
        "unsupported_reason": null,
        "duplicated_from_id": null,
        "submitted_at": "2026-10-17T08:00:00.000Z",
        "archived_at": null,
        "created_at": "2026-10-17T07:50:00.000Z",
        "updated_at": "2026-10-17T08:00:00.000Z"
      }
    ]
  }
}

Example response. Identifiers are illustrative.

Authorization#

Query parameters#

Response#

Authorization

Query parameters

Response