Engagive API documentation

Channels · WhatsApp · Messages

Upload media

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.

Upload an image, video, audio, or document, then use the returned url as `media_url` on send-single. Multipart field name: file.

POST

Upload chat media

Required permission: WhatsApp Chats — Add or Edit

Multipart upload (`file` field, max 25 MB). Returns a url you can pass as `media_url` on send-single. Use Postman or your HTTP client — Try it does not attach files.

Path
/api/business/public/channels/whatsapp/accounts/:accountId/messages/upload-media
Example success response (JSON)
{
  "success": true,
  "statusCode": 200,
  "data": {
    "url": "https://api.engagive.com/uploads/whatsapp/chat/....jpg",
    "path": "/uploads/whatsapp/chat/....jpg"
  }
}

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/upload-media