Skip to main content
GET
List Campaigns

Overview

List campaigns for the authenticated team. This endpoint returns a plain array of campaigns.

Backward Compatibility

  • Default behavior remains unchanged: GET /v1/campaigns returns a plain array of campaigns.
  • Existing integrations do not need to change anything.

Optional Pagination Params

  • limit is optional.
  • If both pagination params are omitted, the endpoint returns the full list.
  • If either pagination param is provided, pagination mode is used.
  • Default offset: 0
  • Maximum: 100
  • Response shape does not change.

Examples

Legacy full-list request:
With an explicit limit:
With limit and offset:
Legacy response:

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

limit
integer<int32>
default:20

Maximum number of campaigns to return

Required range: x <= 100
after
string

Cursor for pagination

Response

List of campaigns

id
string
Example:

"campaign_12345abcde"

name
string
Example:

"Q2 Sales Outreach"

status
enum<string>
Available options:
draft,
active,
paused,
completed
Example:

"active"

agent
string
Example:

"agent_abcdef123456"

product
string
Example:

"prod_123456789"

createdAt
string<date-time>
Example:

"2023-06-15T10:30:00Z"

stats
object
Last modified on March 19, 2026