{ "opencollection": "1.0.0", "info": { "name": "Klaviyo Accounts Campaigns API", "version": "2026-04-15" }, "request": { "auth": { "type": "apikey", "key": "Authorization", "value": "{{Authorization}}", "placement": "header" } }, "items": [ { "info": { "name": "Campaigns", "type": "folder" }, "items": [ { "info": { "name": "Get Campaigns", "type": "http" }, "http": { "method": "GET", "url": "https://a.klaviyo.com/api/campaigns", "headers": [ { "name": "revision", "value": "" } ], "params": [ { "name": "fields[campaign-message]", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets" }, { "name": "fields[campaign]", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets" }, { "name": "fields[tag]", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets" }, { "name": "filter", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering
Allowed field(s)/operator(s):
`id`: `any`
`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`" }, { "name": "include", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships" }, { "name": "page[cursor]", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination" }, { "name": "page[size]", "value": "", "type": "query", "description": "Default: 100. Min: 1. Max: 100." }, { "name": "sort", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sorting" } ] }, "docs": "Returns some or all campaigns based on filters.\n\nA channel filter is required to list campaigns. Please provide either:\n`?filter=equals(messages.channel,'email')` to list email campaigns, or\n`?filter=equals(messages.channel,'sms')` to list SMS campaigns.\n`?filter=equals(messages.channel,'mobile_push')` to list mobile push campaigns.

*Rate limits*:
Burst: `10/s`
Steady: `150/m`\n\n**Scopes:**\n`campaigns:read`" }, { "info": { "name": "Create Campaign", "type": "http" }, "http": { "method": "POST", "url": "https://a.klaviyo.com/api/campaigns", "headers": [ { "name": "revision", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Creates a campaign given a set of parameters, then returns it.

*Rate limits*:
Burst: `10/s`
Steady: `150/m`\n\n**Scopes:**\n`campaigns:write`" }, { "info": { "name": "Get Campaign", "type": "http" }, "http": { "method": "GET", "url": "https://a.klaviyo.com/api/campaigns/:id", "headers": [ { "name": "revision", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path", "description": "The campaign ID to be retrieved" }, { "name": "fields[campaign-message]", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets" }, { "name": "fields[campaign]", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets" }, { "name": "fields[tag]", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets" }, { "name": "include", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships" } ] }, "docs": "Returns a specific campaign based on a required id.

*Rate limits*:
Burst: `10/s`
Steady: `150/m`\n\n**Scopes:**\n`campaigns:read`" }, { "info": { "name": "Update Campaign", "type": "http" }, "http": { "method": "PATCH", "url": "https://a.klaviyo.com/api/campaigns/:id", "headers": [ { "name": "revision", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path", "description": "The campaign ID to be retrieved" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Update a campaign with the given campaign ID.

*Rate limits*:
Burst: `10/s`
Steady: `150/m`\n\n**Scopes:**\n`campaigns:write`" }, { "info": { "name": "Delete Campaign", "type": "http" }, "http": { "method": "DELETE", "url": "https://a.klaviyo.com/api/campaigns/:id", "headers": [ { "name": "revision", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path", "description": "The campaign ID to be deleted" } ] }, "docs": "Delete a campaign with the given campaign ID.

*Rate limits*:
Burst: `10/s`
Steady: `150/m`\n\n**Scopes:**\n`campaigns:write`" }, { "info": { "name": "Get Campaign Message", "type": "http" }, "http": { "method": "GET", "url": "https://a.klaviyo.com/api/campaign-messages/:id", "headers": [ { "name": "revision", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path", "description": "The message ID to be retrieved" }, { "name": "fields[campaign-message]", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets" }, { "name": "fields[campaign]", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets" }, { "name": "fields[image]", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets" }, { "name": "fields[template]", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets" }, { "name": "include", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships" } ] }, "docs": "Returns a specific message based on a required id.

*Rate limits*:
Burst: `10/s`
Steady: `150/m`\n\n**Scopes:**\n`campaigns:read`" }, { "info": { "name": "Update Campaign Message", "type": "http" }, "http": { "method": "PATCH", "url": "https://a.klaviyo.com/api/campaign-messages/:id", "headers": [ { "name": "revision", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path", "description": "The message ID to be retrieved" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Update a campaign message

*Rate limits*:
Burst: `10/s`
Steady: `150/m`\n\n**Scopes:**\n`campaigns:write`" }, { "info": { "name": "Get Campaign Send Job", "type": "http" }, "http": { "method": "GET", "url": "https://a.klaviyo.com/api/campaign-send-jobs/:id", "headers": [ { "name": "revision", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path", "description": "The ID of the campaign to send" }, { "name": "fields[campaign-send-job]", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets" } ] }, "docs": "Get a campaign send job

*Rate limits*:
Burst: `10/s`
Steady: `150/m`\n\n**Scopes:**\n`campaigns:read`" }, { "info": { "name": "Cancel Campaign Send", "type": "http" }, "http": { "method": "PATCH", "url": "https://a.klaviyo.com/api/campaign-send-jobs/:id", "headers": [ { "name": "revision", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path", "description": "The ID of the currently sending campaign to cancel or revert" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Permanently cancel the campaign, setting the status to CANCELED or\nrevert the campaign, setting the status back to DRAFT

*Rate limits*:
Burst: `10/s`
Steady: `150/m`\n\n**Scopes:**\n`campaigns:write`" }, { "info": { "name": "Get Campaign Recipient Estimation Job", "type": "http" }, "http": { "method": "GET", "url": "https://a.klaviyo.com/api/campaign-recipient-estimation-jobs/:id", "headers": [ { "name": "revision", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path", "description": "The ID of the campaign to get recipient estimation status" }, { "name": "fields[campaign-recipient-estimation-job]", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets" } ] }, "docs": "Retrieve the status of a recipient estimation job triggered\nwith the `Create Campaign Recipient Estimation Job` endpoint.

*Rate limits*:
Burst: `10/s`
Steady: `150/m`\n\n**Scopes:**\n`campaigns:read`" }, { "info": { "name": "Get Campaign Recipient Estimation", "type": "http" }, "http": { "method": "GET", "url": "https://a.klaviyo.com/api/campaign-recipient-estimations/:id", "headers": [ { "name": "revision", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path", "description": "The ID of the campaign for which to get the estimated number of recipients" }, { "name": "fields[campaign-recipient-estimation]", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets" } ] }, "docs": "Get the estimated recipient count for a campaign with the provided campaign ID.\nYou can refresh this count by using the `Create Campaign Recipient Estimation Job` endpoint.

*Rate limits*:
Burst: `10/s`
Steady: `150/m`\n\n**Scopes:**\n`campaigns:read`" }, { "info": { "name": "Create Campaign Clone", "type": "http" }, "http": { "method": "POST", "url": "https://a.klaviyo.com/api/campaign-clone", "headers": [ { "name": "revision", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Clones an existing campaign, returning a new campaign based on the original with a new ID and name.

*Rate limits*:
Burst: `10/s`
Steady: `150/m`\n\n**Scopes:**\n`campaigns:write`" }, { "info": { "name": "Assign Template to Campaign Message", "type": "http" }, "http": { "method": "POST", "url": "https://a.klaviyo.com/api/campaign-message-assign-template", "headers": [ { "name": "revision", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Creates a non-reusable version of the template and assigns it to the message.

*Rate limits*:
Burst: `10/s`
Steady: `150/m`\n\n**Scopes:**\n`campaigns:write`" }, { "info": { "name": "Send Campaign", "type": "http" }, "http": { "method": "POST", "url": "https://a.klaviyo.com/api/campaign-send-jobs", "headers": [ { "name": "revision", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Trigger a campaign to send asynchronously

*Rate limits*:
Burst: `10/s`
Steady: `150/m`\n\n**Scopes:**\n`campaigns:write`" }, { "info": { "name": "Refresh Campaign Recipient Estimation", "type": "http" }, "http": { "method": "POST", "url": "https://a.klaviyo.com/api/campaign-recipient-estimation-jobs", "headers": [ { "name": "revision", "value": "" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Trigger an asynchronous job to update the estimated number of recipients\nfor the given campaign ID. Use the `Get Campaign Recipient Estimation\nJob` endpoint to retrieve the status of this estimation job. Use the\n`Get Campaign Recipient Estimation` endpoint to retrieve the estimated\nrecipient count for a given campaign.

*Rate limits*:
Burst: `10/s`
Steady: `150/m`\n\n**Scopes:**\n`campaigns:write`" }, { "info": { "name": "Get Campaign for Campaign Message", "type": "http" }, "http": { "method": "GET", "url": "https://a.klaviyo.com/api/campaign-messages/:id/campaign", "headers": [ { "name": "revision", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path" }, { "name": "fields[campaign]", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets" } ] }, "docs": "Return the related campaign

*Rate limits*:
Burst: `10/s`
Steady: `150/m`\n\n**Scopes:**\n`campaigns:read`" }, { "info": { "name": "Get Campaign ID for Campaign Message", "type": "http" }, "http": { "method": "GET", "url": "https://a.klaviyo.com/api/campaign-messages/:id/relationships/campaign", "headers": [ { "name": "revision", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path" } ] }, "docs": "Returns the ID of the related campaign

*Rate limits*:
Burst: `10/s`
Steady: `150/m`\n\n**Scopes:**\n`campaigns:read`" }, { "info": { "name": "Get Template for Campaign Message", "type": "http" }, "http": { "method": "GET", "url": "https://a.klaviyo.com/api/campaign-messages/:id/template", "headers": [ { "name": "revision", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path" }, { "name": "fields[template]", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets" } ] }, "docs": "Return the related template

*Rate limits*:
Burst: `10/s`
Steady: `150/m`\n\n**Scopes:**\n`campaigns:read`\n`templates:read`" }, { "info": { "name": "Get Template ID for Campaign Message", "type": "http" }, "http": { "method": "GET", "url": "https://a.klaviyo.com/api/campaign-messages/:id/relationships/template", "headers": [ { "name": "revision", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path" } ] }, "docs": "Returns the ID of the related template

*Rate limits*:
Burst: `10/s`
Steady: `150/m`\n\n**Scopes:**\n`campaigns:read`\n`templates:read`" }, { "info": { "name": "Get Image for Campaign Message", "type": "http" }, "http": { "method": "GET", "url": "https://a.klaviyo.com/api/campaign-messages/:id/image", "headers": [ { "name": "revision", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path" }, { "name": "fields[image]", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets" } ] }, "docs": "Return the related image for a given campaign message

*Rate limits*:
Burst: `10/s`
Steady: `150/m`\n\n**Scopes:**\n`campaigns:read`\n`images:read`" }, { "info": { "name": "Get Image ID for Campaign Message", "type": "http" }, "http": { "method": "GET", "url": "https://a.klaviyo.com/api/campaign-messages/:id/relationships/image", "headers": [ { "name": "revision", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path" } ] }, "docs": "Returns the ID of the related image

*Rate limits*:
Burst: `10/s`
Steady: `150/m`\n\n**Scopes:**\n`campaigns:read`\n`images:read`" }, { "info": { "name": "Update Image for Campaign Message", "type": "http" }, "http": { "method": "PATCH", "url": "https://a.klaviyo.com/api/campaign-messages/:id/relationships/image", "headers": [ { "name": "revision", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path" } ], "body": { "type": "json", "data": "{}" } }, "docs": "Update a campaign message image

*Rate limits*:
Burst: `10/s`
Steady: `150/m`\n\n**Scopes:**\n`campaigns:write`\n`images:read`" }, { "info": { "name": "Get Tags for Campaign", "type": "http" }, "http": { "method": "GET", "url": "https://a.klaviyo.com/api/campaigns/:id/tags", "headers": [ { "name": "revision", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path" }, { "name": "fields[tag]", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets" } ] }, "docs": "Return all tags that belong to the given campaign.

*Rate limits*:
Burst: `3/s`
Steady: `60/m`\n\n**Scopes:**\n`campaigns:read`\n`tags:read`" }, { "info": { "name": "Get Tag IDs for Campaign", "type": "http" }, "http": { "method": "GET", "url": "https://a.klaviyo.com/api/campaigns/:id/relationships/tags", "headers": [ { "name": "revision", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path" } ] }, "docs": "Returns the IDs of all tags associated with the given campaign.

*Rate limits*:
Burst: `3/s`
Steady: `60/m`\n\n**Scopes:**\n`campaigns:read`\n`tags:read`" }, { "info": { "name": "Get Messages for Campaign", "type": "http" }, "http": { "method": "GET", "url": "https://a.klaviyo.com/api/campaigns/:id/campaign-messages", "headers": [ { "name": "revision", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path" }, { "name": "fields[campaign-message]", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets" }, { "name": "fields[campaign]", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets" }, { "name": "fields[image]", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets" }, { "name": "fields[template]", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets" }, { "name": "include", "value": "", "type": "query", "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships" } ] }, "docs": "Return all messages that belong to the given campaign.

*Rate limits*:
Burst: `10/s`
Steady: `150/m`\n\n**Scopes:**\n`campaigns:read`" }, { "info": { "name": "Get Message IDs for Campaign", "type": "http" }, "http": { "method": "GET", "url": "https://a.klaviyo.com/api/campaigns/:id/relationships/campaign-messages", "headers": [ { "name": "revision", "value": "" } ], "params": [ { "name": "id", "value": "", "type": "path" } ] }, "docs": "Returns the IDs of all messages associated with the given campaign.

*Rate limits*:
Burst: `10/s`
Steady: `150/m`\n\n**Scopes:**\n`campaigns:read`" } ] } ], "bundled": true }