List Campaign Contacts

curl --request GET \
  --url https://api.example.com/v1/campaigns/{id}/contacts

{
  "data": {
    "contacts": [
      {
        "contact_id": "<string>",
        "full_name": "<string>",
        "email": "<string>",
        "status": "<string>",
        "current_step": 123,
        "added_at": "<string>",
        "last_sent_at": "<string>"
      }
    ]
  },
  "meta": {
    "page": 123,
    "per_page": 123,
    "total": 123
  }
}

GET

campaigns

{id}

contacts

List Campaign Contacts

curl --request GET \
  --url https://api.example.com/v1/campaigns/{id}/contacts

{
  "data": {
    "contacts": [
      {
        "contact_id": "<string>",
        "full_name": "<string>",
        "email": "<string>",
        "status": "<string>",
        "current_step": 123,
        "added_at": "<string>",
        "last_sent_at": "<string>"
      }
    ]
  },
  "meta": {
    "page": 123,
    "per_page": 123,
    "total": 123
  }
}

Request

Path Parameters

string

required

The campaign’s unique ID (UUID)

Query Parameters

page

integer

default:"1"

Page number for pagination

per_page

integer

default:"50"

Number of contacts per page (max: 100)

status

string

Filter by enrollment status: pending, active, paused, completed, bounced, unsubscribed, or replied

Headers

Authorization: Bearer wbk_your_api_key_here

Requires an API key with the campaigns:read permission.

Response

data

object

Show properties

contacts

array

Enrolled contacts, newest first.

Show Contact enrollment object

contact_id

string

Contact UUID

full_name

string

Contact’s full name

string

Contact email

status

string

Enrollment status (see query filter)

current_step

integer

Zero-based index of the next step to send

added_at

string

ISO 8601 timestamp when contact was added

last_sent_at

string

ISO 8601 timestamp of last email sent (nullable)

Example Response

{
  "data": {
    "contacts": [
      {
        "contact_id": "123e4567-e89b-12d3-a456-426614174000",
        "full_name": "Jane Doe",
        "email": "jane@example.com",
        "status": "active",
        "current_step": 2,
        "added_at": "2026-04-01T09:00:00Z",
        "last_sent_at": "2026-04-15T09:00:00Z"
      }
    ]
  },
  "meta": { "page": 1, "per_page": 50, "total": 147 }
}

Errors

Status	Code	Description
401	`invalid_key`	Invalid or expired API key
403	`insufficient_permissions`	Missing `campaigns:read` permission
404	`campaign_not_found`	No campaign with this ID
429	`rate_limited`	Rate limit exceeded

Pause Campaign Add Contacts to Campaign

​Request

​Path Parameters

​Query Parameters

​Headers

​Response

​Example Response

​Errors

Request

Path Parameters

Query Parameters

Headers

Response

Example Response

Errors