GET /api/campaigns

Returns some or all campaigns based on filters.

A channel filter is required to list campaigns. Please provide either: ?filter=equals(messages.channel,'email') to list email campaigns, or ?filter=equals(messages.channel,'sms') to list SMS campaigns. ?filter=equals(messages.channel,'mobile_push') to list mobile push campaigns.

Rate limits:
Burst: 10/s
Steady: 150/m

Scopes: campaigns:read

Servers

Request headers

Name Type Required Description
revision String Yes

API endpoint revision (format: YYYY-MM-DD[.suffix])

Default value: "2025-07-15"

Query parameters

Name Type Required Description
page[cursor] String No

For more information please visit https://developers.klaviyo.com/en/v2025-07-15/reference/api-overview#pagination

include[] Array No

For more information please visit https://developers.klaviyo.com/en/v2025-07-15/reference/api-overview#relationships

filter String Yes

For more information please visit https://developers.klaviyo.com/en/v2025-07-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
messages.channel: equals
name: contains
status: any, equals
archived: equals
created_at: greater-or-equal, greater-than, less-or-equal, less-than
scheduled_at: greater-or-equal, greater-than, less-or-equal, less-than
updated_at: greater-or-equal, greater-than, less-or-equal, less-than

sort String No

For more information please visit https://developers.klaviyo.com/en/v2025-07-15/reference/api-overview#sorting

Possible values:

  • "id"
  • "name"
  • "-name"
  • "scheduled_at"
  • "-id"
  • "-scheduled_at"
  • "created_at"
  • "-created_at"
  • "updated_at"
  • "-updated_at"
fields[campaign][] Array No

For more information please visit https://developers.klaviyo.com/en/v2025-07-15/reference/api-overview#sparse-fieldsets

fields[tag][] Array No

For more information please visit https://developers.klaviyo.com/en/v2025-07-15/reference/api-overview#sparse-fieldsets

fields[campaign-message][] Array No

For more information please visit https://developers.klaviyo.com/en/v2025-07-15/reference/api-overview#sparse-fieldsets

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.