Klaviyo Campaigns API is one of 23 APIs that Klaviyo publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.
Tagged areas include Campaigns. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, an API reference, authentication docs, and rate-limit docs.
This API exposes 26 operations across 20 paths, and defines 110 schemas. It is described by OpenAPI 3.0.2, at version 2026-04-15.
Requests are made against a single base URL, https://a.klaviyo.com.
26 operations
20 paths
110 schemas
1 DELETE16 GET4 PATCH5 POST
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 1
Klaviyo Campaigns API declares
1 security scheme
for authenticating requests.
An API key is passed in the header as Authorization (Klaviyo-API-Key).
By default, every request must be authenticated.
Klaviyo-API-Key— Private key authentication for /api/ endpoints is performed by setting the Authorization header to Klaviyo-API-Key your-private-api-key For more information pl…
Paths & Operations 26
Across 20 paths, the API surfaces 26 operations — 1 DELETE, 16 GET, 4 PATCH, 5 POST. Each is listed below with its method, path, parameters, and response codes.
Campaigns 26
campaigns
GET
/api/campaigns
Get Campaigns
POST
/api/campaigns
Create Campaign
GET
/api/campaigns/{id}
Get Campaign
PATCH
/api/campaigns/{id}
Update Campaign
DELETE
/api/campaigns/{id}
Delete Campaign
GET
/api/campaign-messages/{id}
Get Campaign Message
PATCH
/api/campaign-messages/{id}
Update Campaign Message
GET
/api/campaign-send-jobs/{id}
Get Campaign Send Job
PATCH
/api/campaign-send-jobs/{id}
Cancel Campaign Send
GET
/api/campaign-recipient-estimation-jobs/{id}
Get Campaign Recipient Estimation Job
GET
/api/campaign-recipient-estimations/{id}
Get Campaign Recipient Estimation
POST
/api/campaign-clone
Create Campaign Clone
POST
/api/campaign-message-assign-template
Assign Template to Campaign Message
POST
/api/campaign-send-jobs
Send Campaign
POST
/api/campaign-recipient-estimation-jobs
Refresh Campaign Recipient Estimation
GET
/api/campaign-messages/{id}/campaign
Get Campaign for Campaign Message
GET
/api/campaign-messages/{id}/relationships/campaign
Get Campaign ID for Campaign Message
GET
/api/campaign-messages/{id}/template
Get Template for Campaign Message
GET
/api/campaign-messages/{id}/relationships/template
Get Template ID for Campaign Message
GET
/api/campaign-messages/{id}/image
Get Image for Campaign Message
GET
/api/campaign-messages/{id}/relationships/image
Get Image ID for Campaign Message
PATCH
/api/campaign-messages/{id}/relationships/image
Update Image for Campaign Message
GET
/api/campaigns/{id}/tags
Get Tags for Campaign
GET
/api/campaigns/{id}/relationships/tags
Get Tag IDs for Campaign
GET
/api/campaigns/{id}/campaign-messages
Get Messages for Campaign
GET
/api/campaigns/{id}/relationships/campaign-messages
Get Message IDs for Campaign
Schemas 110
The contract defines 110 schemas that model the data the API accepts and returns. The most detailed are EmailContentSubObject (7 properties), EmailContent (7 properties), CampaignResponseObjectResource (5 properties), TagResponseObjectResource (5 properties). Each schema is shown below with its type and property counts.
CampaignMessageIncrement
object
1 property
1 required
CampaignMessageCreateQueryResourceObject
object
3 properties
2 required
MobilePushOptions
object
3 properties
ImageResponseObjectResource
object
4 properties
4 required
CampaignPartialUpdateQueryResourceObject
object
3 properties
3 required
StaticSendStrategy
object
3 properties
2 required
CampaignMessageEnum
string
SMSContentCreate
object
1 property
GetTagResponseCollection
object
2 properties
1 required
ListEnum
string
GetCampaignResponseCompoundDocument
object
3 properties
1 required
CampaignMessageAssignTemplateQueryResourceObject
object
3 properties
3 required
PushSendOptions
object
1 property
GetCampaignMessageCampaignRelationshipResponse
object
2 properties
1 required
Audiences
object
2 properties
1 required
GetCampaignMessageResponseCollectionCompoundDocument
object
3 properties
1 required
CampaignMessageResponseObjectResource
object
5 properties
4 required
CampaignRecipientEstimationJobCreateQueryResourceObject
object
2 properties
2 required
StaticTrackingParam
object
3 properties
3 required
ObjectLinks
object
1 property
1 required
EmailContentSubObject
object
7 properties
ABTestSendStrategy
object
1 property
1 required
TagEnum
string
SMSContent
object
2 properties
GetCampaignResponse
object
2 properties
1 required
SendTime
object
2 properties
2 required
CampaignMessagePartialUpdateQueryResourceObject
object
4 properties
3 required
SMSContentSubObject
object
2 properties
PostCampaignSendJobResponse
object
2 properties
1 required
MobilePushNoBadge
object
1 property
1 required
CampaignCreateQuery
object
1 property
1 required
CampaignResponseObjectResource
object
5 properties
4 required
PatchCampaignMessageResponse
object
2 properties
1 required
EmailContent
object
7 properties
SMSMessageDefinitionCreate
object
3 properties
1 required
CampaignMessageStaticCount
object
2 properties
2 required
ImageEnum
string
MobilePushMessageStandardDefinitionUpdate
object
5 properties
1 required
CampaignMessageAssignTemplateQuery
object
1 property
1 required
GetCampaignMessageResponseCompoundDocument
object
3 properties
1 required
MobilePushMessageStandardDefinitionCreate
object
5 properties
2 required
RenderOptionsSubObject
object
4 properties
GetTemplateResponse
object
2 properties
1 required
FlowEnum
string
CampaignEnum
string
LocalStaticSend
object
2 properties
1 required
MobilePushContentUpdate
object
4 properties
MobilePushContent
object
4 properties
CampaignCloneQuery
object
1 property
1 required
AudiencesUpdate
object
2 properties
PostCampaignRecipientEstimationJobResponse
object
2 properties
1 required
PatchCampaignResponse
object
2 properties
1 required
CampaignRecipientEstimationJobEnum
string
GetCampaignMessagesRelationshipsResponseCollection
object
2 properties
1 required
RelationshipLinks
object
2 properties
2 required
MobilePushMessageSilentDefinition
object
3 properties
2 required
CampaignMessageProperty
object
2 properties
2 required
GetCampaignMessageTemplateRelationshipResponse
object
2 properties
1 required
GetCampaignResponseCollectionCompoundDocument
object
3 properties
1 required
MobilePushMessageSilentDefinitionUpdate
object
3 properties
1 required
CampaignRecipientEstimationJobResponseObjectResource
object
4 properties
4 required
CampaignRecipientEstimationEnum
string
EmailSendOptions
object
1 property
CampaignCloneQueryResourceObject
object
3 properties
3 required
SMSMessageDefinition
object
3 properties
1 required
TagResponseObjectResource
object
5 properties
4 required
PushOnOpenApp
object
1 property
1 required
SmartSendTimeStrategy
object
2 properties
2 required
MobilePushMessageSilentDefinitionCreate
object
3 properties
1 required
SegmentEnum
string
MobilePushContentCreate
object
4 properties
1 required
PushOnOpenDeepLink
object
3 properties
1 required
TagGroupEnum
string
PushActionButtonDefinition
object
4 properties
2 required
GetCampaignRecipientEstimationResponse
object
2 properties
1 required
CampaignSendJobPartialUpdateQueryResourceObject
object
3 properties
3 required
EmailMessageDefinition
object
3 properties
1 required
CampaignRecipientEstimationResponseObjectResource
object
4 properties
4 required
ThrottledSendStrategy
object
3 properties
3 required
CampaignSendJobResponseObjectResource
object
4 properties
4 required
CampaignMessageImageUpdateQuery
object
1 property
1 required
SMSSendOptions
object
1 property
PostCampaignResponse
object
2 properties
1 required
CampaignsEmailTrackingOptions
object
4 properties
CampaignRecipientEstimationJobCreateQuery
object
1 property
1 required
UnsupportedSendStrategy
object
1 property
1 required
CampaignMessagePartialUpdateQuery
object
1 property
1 required
RenderOptions
object
4 properties
GetCampaignMessageImageRelationshipResponse
object
2 properties
1 required
GetImageResponse
object
2 properties
1 required
MobilePushMessageStandardDefinition
object
5 properties
3 required
TemplateEnum
string
CampaignPartialUpdateQuery
object
1 property
1 required
CampaignCreateQueryResourceObject
object
2 properties
2 required
GetCampaignTagsRelationshipsResponseCollection
object
2 properties
1 required
PostCampaignMessageResponse
object
2 properties
1 required
GetCampaignRecipientEstimationJobResponse
object
2 properties
1 required
CampaignSendJobCreateQueryResourceObject
object
2 properties
2 required
GetCampaignSendJobResponse
object
2 properties
1 required
MobilePushBadge
object
2 properties
1 required
CampaignSendJobEnum
string
CampaignSendJobPartialUpdateQuery
object
1 property
1 required
ImmediateSendStrategy
object
1 property
1 required
SendTimeSubObject
object
2 properties
2 required
CampaignsSMSTrackingOptions
object
2 properties
NonLocalStaticSend
object
1 property
1 required
CollectionLinks
object
5 properties
1 required
DynamicTrackingParam
object
3 properties
3 required
CampaignSendJobCreateQuery
object
1 property
1 required
TemplateResponseObjectResource
object
4 properties
4 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Klaviyo 12
Other APIs Klaviyo publishes across the network.
Klaviyo Accounts API
Klaviyo Catalogs API
Klaviyo Client API
Klaviyo Conversations API
Klaviyo Coupons API
Klaviyo Custom Objects API
Klaviyo Data Privacy API
Klaviyo Events API
Klaviyo Flows API
Klaviyo Forms API
Klaviyo Images API
Klaviyo Lists API
#Campaigns