POST /api/events
Create a new event to track a profile's activity.
Note that this endpoint allows you to create a new profile or update an existing profile's properties.
At a minimum, profile and metric objects should include at least one profile identifier (e.g., id, email, or phone_number) and the metric name, respectively.
Successful response indicates that the event was validated and submitted for processing, but does not guarantee that processing is complete.
Rate limits:
Burst: 350/s
Steady: 3500/m
Scopes:
events: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" |
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.