POST /client/profiles
Create or update properties about a profile without tracking an associated event.
This endpoint is specifically designed to be called from publicly-browseable, client-side environments only and requires a public API key (site ID). Never use a private API key with our client-side endpoints.
Do not use this endpoint from server-side applications. To create or update profiles from server-side applications, instead use POST /api/profile-import.
Note that to update a profile's existing identifiers (e.g., email), you must use a server-side endpoint authenticated by a private API key. Attempts to do so via client-side endpoints will return a 202, however the identifier field(s) will not be updated.
Rate limits:
Burst: 350/s
Steady: 3500/m
Scopes:
profiles:write
Servers
- https://a.klaviyo.com
Request headers
| Name | Type | Required | Description |
|---|---|---|---|
revision |
String | Yes |
API endpoint revision (format: YYYY-MM-DD[.suffix]) Default value: "2025-04-15" |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
company_id |
String | Yes |
Your Public API Key / Site ID. See this article for more details. |
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.