Skip to main content
POST
/
v1
/
contacts
/
bulk
Bulk Create Contacts
curl --request POST \
  --url https://api.example.com/v1/contacts/bulk \
  --header 'Content-Type: application/json' \
  --data '
{
  "contacts": [
    {
      "full_name": "<string>",
      "email": "<string>",
      "phone": "<string>",
      "job_title": "<string>",
      "company": "<string>",
      "linkedin_url": "<string>",
      "tags": [
        {}
      ],
      "custom_fields": {}
    }
  ]
}
'
{
  "data": {
    "created": 123,
    "contacts": [
      {}
    ]
  }
}

Request

Headers

Authorization: Bearer wbk_your_api_key_here
Content-Type: application/json

Body Parameters

contacts
array
required
Array of contact objects (max 500)

Response

data
object
curl -X POST https://data.leadlex.com/functions/v1/api-gateway/v1/contacts/bulk \
  -H "Authorization: Bearer wbk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "contacts": [
      { "full_name": "Jane Doe", "email": "jane@example.com", "job_title": "CEO" },
      { "full_name": "John Smith", "email": "john@example.com", "company": "Acme Inc" }
    ]
  }'

Example Response

{
  "data": {
    "created": 2,
    "contacts": [
      { "id": "abc-123", "full_name": "Jane Doe", "email": "jane@example.com" },
      { "id": "def-456", "full_name": "John Smith", "email": "john@example.com" }
    ]
  }
}

Errors

StatusCodeDescription
400validation_errorMissing or invalid contacts array
400validation_errorMore than 500 contacts
403insufficient_permissionsMissing contacts:write permission
429rate_limitedRate limit exceeded