Documentation

API - Bulk Upload Leads

Last updated on December 22, 2025

POST

https://client-api.e-so.in/api/engage/v1/leads/bulk-create

AUTHORIZATION

Required

 - Bearer Token in the Authorization header

Header Format Examples:

Authorization: Bearer <access_token>;

Error States:

  • 401 Unauthorized: Missing, expired or invalid token.
  •  Error Response Example:

    {
      "status": 401,
      "message": "UnAuthorized Access-Token!",
      "success": false
    }

 

Note - Only one of the headers is required. If both are present, Authorization is preferred.

Request Specifications

Headers

HeaderRequiredExample ValueDescription
AuthorizationYesBearer eyJhbGci...Bearer token for authentication
Content-TypeYesapplication/jsonRequest body media type
AcceptNoapplication/jsonExpected response media type

Body

{
    "data": [
        {
            "contact_number": 1234567890,
            "country_code": 91,
            "origin": "UPLOAD",
            "name": "Patel"
        }
    ]
}

EXAMPLE REQUEST

curl --location 'client-api.e-so.in/api/engage/v1/leads/bulk-create' \
--data '{
    "data": [
        {
            "contact_number": 1234567890,
            "country_code": 91,
            "origin": "UPLOAD",
            "name": "Patel"
        }
    ]
}'

EXAMPLE RESPONSE

{
  "status": 201,
  "success": true,
  "message": "New Contacts successfully added!"
}