Add Contacts to Campaign

curl --request POST \
  --url https://api.example.com/v1/campaigns/{id}/contacts \
  --header 'Content-Type: application/json' \
  --data '
{
  "contact_ids": [
    {}
  ],
  "source": "<string>"
}
'

{
  "data": {
    "added": 123,
    "skipped": 123,
    "contact_ids": [
      {}
    ]
  }
}

POST

campaigns

{id}

contacts

Add Contacts to Campaign

curl --request POST \
  --url https://api.example.com/v1/campaigns/{id}/contacts \
  --header 'Content-Type: application/json' \
  --data '
{
  "contact_ids": [
    {}
  ],
  "source": "<string>"
}
'

{
  "data": {
    "added": 123,
    "skipped": 123,
    "contact_ids": [
      {}
    ]
  }
}

Request

Path Parameters

string

required

The campaign’s unique ID (UUID)

Headers

Authorization: Bearer wbk_your_api_key_here
Content-Type: application/json

Requires an API key with the campaigns:write permission. Fires the campaign.contacts_added webhook event.

Body Parameters

contact_ids

array

required

Array of contact UUIDs to enroll. Maximum 500 per request. Duplicates are silently skipped.

source

string

Optional free-form tag describing where these contacts came from (e.g., list:cold-outreach-q2, import:csv-2026-04). Stored on each enrollment for analytics.

Response

data

object

Show properties

added

integer

Number of contacts newly enrolled

skipped

integer

Number of contacts already enrolled (no-op)

contact_ids

array

IDs of contacts that were newly added

curl -X POST https://data.leadlex.com/functions/v1/api-gateway/v1/campaigns/cmp_abc123/contacts \
  -H "Authorization: Bearer wbk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "contact_ids": [
      "123e4567-e89b-12d3-a456-426614174000",
      "223e4567-e89b-12d3-a456-426614174001"
    ],
    "source": "list:cold-outreach-q2"
  }'

Example Response

{
  "data": {
    "added": 2,
    "skipped": 0,
    "contact_ids": [
      "123e4567-e89b-12d3-a456-426614174000",
      "223e4567-e89b-12d3-a456-426614174001"
    ]
  }
}

Errors

Status	Code	Description
400	`too_many_contacts`	More than 500 contacts in a single request
400	`missing_required_field`	`contact_ids` missing or empty
401	`invalid_key`	Invalid or expired API key
403	`insufficient_permissions`	Missing `campaigns:write` permission
404	`campaign_not_found`	No campaign with this ID
429	`rate_limited`	Rate limit exceeded

List Campaign Contacts Remove Contact from Campaign

​Request

​Path Parameters

​Headers

​Body Parameters

​Response

​Example Response

​Errors

Request

Path Parameters

Headers

Body Parameters

Response

Example Response

Errors