Engagive API documentation

Channels · WhatsApp · Messages

Send Single

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.

Set message_type to `text`, `image`, `video`, … or `interactive`. For `interactive`, provide content_json and validate interactive.type (`list`, `button`, `product`, `product_list`, `catalog_message`).

Unknown to numbers create a contact automatically (`contact_created: true`). Cross-tenant or unknown accountId returns 404.

POST

Send single message

Required permission: WhatsApp Chats — Add

One endpoint for text, media, interactive, location, contacts, sticker, and replies (`parent_whatsapp_message_id`). Phone to: digits with country code (no +). Engagive upserts a contact for `to`, persists the outbound message in chat history, then sends via Meta. Response `data` includes Engagive `id` (DB message id), `whatsapp_message_id`, `contact_id`, `status`, and `template_id` (null for non-template).

Path
/api/business/public/channels/whatsapp/accounts/:accountId/messages/send-single
Example request body (JSON)
{
  "to": "923001234567",
  "message_type": "text",
  "content": "Hello! This is a plain text message.",
  "preview_url": false
}
Example success response (JSON)
{
  "success": true,
  "statusCode": 201,
  "message": "Message sent successfully",
  "data": {
    "id": 1001,
    "whatsapp_message_id": "wamid.HBgMOTE5...",
    "parent_whatsapp_message_id": null,
    "template_id": null,
    "lang_code": null,
    "contact_id": 42,
    "contact_created": false,
    "to": "923001234567",
    "message_type": "text",
    "direction": "outgoing",
    "status": "sent",
    "error_reason": null,
    "content": "Hello! This is a plain text message.",
    "media_url": null,
    "caption": null,
    "content_json": null,
    "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-single