Bulk Create Data Source Records

post https://a.klaviyo.com/api/data-source-record-bulk-create-jobs

🚧
This endpoint is in beta and subject to change.
A beta revision header (2025-04-15.pre) is required to use our beta APIs. Klaviyo APIs in beta are not intended for use in production. See our versioning and deprecation policy for more information.

Create a data source record job.

Custom objects is a paid feature in Klaviyo, only available to customers with a paid email plan. To request access to custom objects, submit this form.

Rate limits:
Burst: 3/s
Steady: 60/m

Scopes:
custom-objects:write

Responses

202

Success

Language

Credentials

Header


xxxxxxxxxx
20
1
curl --request POST \
2
     --url https://a.klaviyo.com/api/data-source-record-bulk-create-jobs \
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.pre' \
7
     --data '
8
{
9
  "data": {
10
    "type": "data-source-record-bulk-create-job",
11
    "relationships": {
12
      "data-source": {
13
        "data": {
14
          "type": "data-source"
15
        }
16
      }
17
    }
18
  }
19
}
20
'


xxxxxxxxxx
14
 
1
{
2
  "errors": [
3
    {
4
      "id": "string",
5
      "code": "string",
6
      "title": "string",
7
      "detail": "string",
8
      "source": {
9
        "pointer": "string",
10
        "parameter": "string"
11
      }
12
    }
13
  ]
14
}

4XXClient Error

5XXServer Error