HomeGuidesAPI Reference
ChangelogHelp CenterCommunityContact Us
API Reference

Bulk Import Profiles

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

Body Params
object
required
string
required
object
required
object
required

Array of profiles to create or update

array of objects
required
data*
string
required
string

Primary key that uniquely identifies this profile. Generated by Klaviyo.

object
required
object
object
object
array of objects
data
string
required
string
required

Optional list to add the profiles to

Headers
string
required
Defaults to 2025-01-15

API endpoint revision (format: YYYY-MM-DD[.suffix])

Responses

Language
Credentials