Engagive API documentation

Channels · WhatsApp · Contacts

Import contacts

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.

Download the CSV sample, then POST a multipart file (CSV or Excel). Import is best-effort per row — check `data.errors` in the response.

GET

Download import sample

Required permission: WhatsApp Contacts — View

Downloads a CSV sample for bulk import. Prefer Postman or curl for file downloads.

Path
/api/business/public/channels/whatsapp/accounts/:accountId/contacts/sample
Example success response (JSON)
{
  "note": "Binary CSV file download (Content-Disposition: attachment)"
}

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
GET https://api.engagive.io/api/business/public/channels/whatsapp/accounts/1/contacts/sample
POST

Import contacts

Required permission: WhatsApp Contacts — Add

Multipart form field file (`.csv` / `.xlsx` / `.xls`, max 50 MB). Use Postman — Try it cannot attach files.

Path
/api/business/public/channels/whatsapp/accounts/:accountId/contacts/import
Example success response (JSON)
{
  "success": true,
  "message": "Import completed",
  "data": {
    "imported": 10,
    "skipped": 1,
    "errors": []
  }
}

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/contacts/import