Engagive API documentation

Channels · WhatsApp · Messages

Send Template

Base URL & auth

  • Prefix: /api/business/public on https://api.engagive.io (full base: https://api.engagive.io/api/business/public).
  • Header: Authorization: Bearer <token> — create the token under Profile → API access token in the business app.
  • See also: Authentication, Errors & responses.

content_json must match your approved template structure on WhatsApp (components, parameters, language). Response includes Engagive `id`, Meta `whatsapp_message_id`, and Engagive `template_id` (resolved from `template_name` / optional `content_json.template_id`).

Same contact upsert and chat persistence as send-single. On Meta failure the message is kept with `status: "failed"` and HTTP 502 (see `data.error_reason`).

POST

Send template

Required permission: WhatsApp Chats — Add

content_json is passed through to Meta (`template_name` / `lang_code` / `components`). Engagive resolves and persists template_id (match `templates.code` to `template_name`, or pass `content_json.template_id`). Response `data` includes Engagive `id`, `whatsapp_message_id`, `template_id`, and `lang_code`. Same contact upsert + chat persistence as send-single.

Path
/api/business/public/channels/whatsapp/accounts/:accountId/messages/send-template
Example request body (JSON)
{
  "to": "923001234567",
  "content_json": {
    "template_name": "hello_world",
    "lang_code": "en_US",
    "components": [
      {
        "type": "BODY",
        "parameters": [
          {
            "type": "text",
            "text": "Hello"
          }
        ]
      }
    ]
  }
}
Example success response (JSON)
{
  "success": true,
  "statusCode": 201,
  "message": "Template message sent successfully",
  "data": {
    "id": 1002,
    "whatsapp_message_id": "wamid.HBgMOTE5...",
    "parent_whatsapp_message_id": null,
    "template_id": 7,
    "lang_code": "en_US",
    "contact_id": 42,
    "contact_created": true,
    "to": "923001234567",
    "message_type": "template",
    "direction": "outgoing",
    "status": "sent",
    "error_reason": null,
    "content": "hello_world",
    "media_url": null,
    "caption": null,
    "content_json": {
      "template_name": "hello_world",
      "lang_code": "en_US",
      "components": [
        {
          "type": "BODY",
          "parameters": [
            {
              "type": "text",
              "text": "Hello"
            }
          ]
        }
      ]
    },
    "created_at": "2026-08-05T00:00:00.000Z",
    "message_time": "2026-08-05T00:00:00.000Z"
  }
}

Try it

Runs in your browser — token is not stored

If the request fails with a network / CORS error, your API may not allow browser calls from this site. Use curl, Postman, or your server instead. See Postman.

Full request URL
POST https://api.engagive.io/api/business/public/channels/whatsapp/accounts/1/messages/send-template