POST /api/profile-import
Given a set of profile attributes and optionally an ID, create or update a profile.
Returns 201 if a new profile was created, 200 if an existing profile was updated.
Use the additional-fields parameter to include subscriptions and predictive analytics data in your response.
Note that setting a field to null will clear out the field, whereas not including a field in your request will leave it unchanged.
The maximum allowed payload size is 100KB.
Rate limits:
Burst: 75/s
Steady: 750/m
Scopes:
profiles:write
OpenAPI Spec
Servers
- https://a.klaviyo.com
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
revision |
String | Yes |
API endpoint revision (format: YYYY-MM-DD[.suffix]) Default value: "2026-04-15" |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
additional-fields[profile][] |
Array | No |
Request additional fields not included by default in the response. Supported values: 'subscriptions', 'predictive_analytics' |
fields[profile][] |
Array | No |
For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.