HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference

Get 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

Query Params
string
required

For more information please visit https://developers.klaviyo.com/en/v2025-01-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

array of strings
fields[campaign-message]
array of strings
fields[campaign]
array of strings
fields[tag]
array of strings
include
Headers
string
required
Defaults to 2025-01-15

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

Responses

Language
Credentials