Create Segment

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

Create a segment.

Rate limits:
Burst: 1/s
Steady: 15/m
Daily: 100/d

Scopes:
segments:write

Responses

Language

Credentials

Header


xxxxxxxxxx
16
1
curl --request POST \
2
     --url https://a.klaviyo.com/api/segments \
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-01-15' \
7
     --data '
8
{
9
  "data": {
10
    "type": "segment",
11
    "attributes": {
12
      "is_starred": false
13
    }
14
  }
15
}
16
'


xxxxxxxxxx
158
}
1
{
2
  "data": {
3
    "type": "segment",
4
    "id": "string",
5
    "attributes": {
6
      "name": "Repeat Purchasers",
7
      "definition": {
8
        "condition_groups": [
9
          {
10
            "conditions": [
11
              {
12
                "type": "profile-group-membership",
13
                "group_ids": [
14
                  "string"
15
                ],
16
                "timeframe_filter": {
17
                  "type": "date",
18
                  "operator": "after",
19
                  "date": "2022-11-08T00:00:00+00:00"
20
                }
21
              },
22
              {
23
                "type": "profile-group-membership",
24
                "group_ids": [
25
                  "string"

201Success

4XXClient Error

5XXServer Error