Create Campaign

post https://a.klaviyo.com/api/campaigns

Creates a campaign given a set of parameters, then returns it.

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

Scopes:
campaigns:write

Responses

Language

Credentials

Header


xxxxxxxxxx
25
1
curl --request POST \
2
     --url https://a.klaviyo.com/api/campaigns \
3
     --header 'Authorization: Klaviyo-API-Key your-private-api-key' \
4
     --header 'accept: application/vnd.api+json' \
5
     --header 'content-type: application/vnd.api+json' \
6
     --header 'revision: 2025-04-15' \
7
     --data '
8
{
9
  "data": {
10
    "type": "campaign",
11
    "attributes": {
12
      "send_strategy": {
13
        "method": "static",
14
        "options": {
15
          "is_local": true,
16
          "send_past_recipients_immediately": false
17
        }
18
      },
19
      "send_options": {
20
        "use_smart_sending": true
21
      }
22
    }
23
  }
24
}
25
'


xxxxxxxxxx
79
}
1
{
2
  "data": {
3
    "type": "campaign",
4
    "id": "string",
5
    "attributes": {
6
      "name": "string",
7
      "status": "Adding Recipients",
8
      "archived": true,
9
      "audiences": {
10
        "included": [
11
          "Y6nRLr"
12
        ],
13
        "excluded": [
14
          "UTd5ui"
15
        ]
16
      },
17
      "send_options": {
18
        "use_smart_sending": true
19
      },
20
      "tracking_options": {
21
        "add_tracking_params": true,
22
        "custom_tracking_params": [
23
          {
24
            "type": "dynamic",
25
            "value": "campaign_id",

201Success

4XXClient Error

5XXServer Error