Spawn Bulk Profile Import Job

post https://a.klaviyo.com/api/profile-bulk-import-jobs/

Create a bulk profile import job to create or update a batch of profiles.

Accepts up to 10,000 profiles per request. The maximum allowed payload size is 5MB.

To learn more, see our Bulk Profile Import API guide.

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

Scopes:
lists:write
profiles:write

Responses

Language

Credentials

Header


xxxxxxxxxx
13
1
curl --request POST \
2
     --url https://a.klaviyo.com/api/profile-bulk-import-jobs/ \
3
     --header 'Authorization: Klaviyo-API-Key your-private-api-key' \
4
     --header 'accept: application/json' \
5
     --header 'content-type: application/json' \
6
     --header 'revision: 2024-07-15' \
7
     --data '
8
{
9
  "data": {
10
    "type": "profile-bulk-import-job"
11
  }
12
}
13
'


xxxxxxxxxx
56
}
1
{
2
  "data": {
3
    "type": "profile-bulk-import-job",
4
    "id": "string",
5
    "attributes": {
6
      "status": "processing",
7
      "created_at": "2022-11-08T00:00:00+00:00",
8
      "total_count": 10,
9
      "completed_count": 9,
10
      "failed_count": 1,
11
      "completed_at": "2022-11-08T00:00:00+00:00",
12
      "expires_at": "2022-11-08T00:00:00+00:00",
13
      "started_at": "2022-11-08T00:00:00+00:00"
14
    },
15
    "relationships": {
16
      "lists": {
17
        "data": [
18
          {
19
            "type": "list",
20
            "id": "string"
21
          }
22
        ],
23
        "links": {
24
          "self": "string",
25
          "related": "string"

202Success

4XXClient Error

5XXServer Error