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

https://a.klaviyo.com

Request headers

Name Type Required Description

Name	Type	Required	Description
`revision`	String	Yes	API endpoint revision (format: YYYY-MM-DD[.suffix]) Default value: "2025-04-15"

revision

String

Yes

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

Default value: "2025-04-15"

Query parameters

Name	Type	Required	Description
`fieldscampaign-message[]`	Array	No	For more information please visit https://developers.klaviyo.com/en/v2025-04-15/reference/api-overview#sparse-fieldsets
`fieldstag[]`	Array	No	For more information please visit https://developers.klaviyo.com/en/v2025-04-15/reference/api-overview#sparse-fieldsets
`include[]`	Array	No	For more information please visit https://developers.klaviyo.com/en/v2025-04-15/reference/api-overview#relationships
`filter`	String	Yes	For more information please visit https://developers.klaviyo.com/en/v2025-04-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-04-15/reference/api-overview#sorting Possible values: `"id"` `"name"` `"-name"` `"scheduled_at"` `"-id"` `"-scheduled_at"` `"created_at"` `"-created_at"` `"updated_at"` `"-updated_at"`
`fieldscampaign[]`	Array	No	For more information please visit https://developers.klaviyo.com/en/v2025-04-15/reference/api-overview#sparse-fieldsets
`pagecursor`	String	No	For more information please visit https://developers.klaviyo.com/en/v2025-04-15/reference/api-overview#pagination

How to start integrating

Add HTTP Task to your workflow definition.
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.
Click Test request to test run your request to the API and see the API's response.