Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Klaviyo Events API is one of 23 APIs that Klaviyo publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include Events. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an AsyncAPI specification, an API reference, authentication docs, and rate-limit docs.

This API exposes 8 operations across 7 paths, and defines 54 schemas. It is described by OpenAPI 3.0.2, at version 2026-04-15.

Requests are made against a single base URL, https://a.klaviyo.com.

8 operations 7 paths 54 schemas 6 GET2 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.2
API Version
2026-04-15
Base URL
https://a.klaviyo.com
Authentication
API Key
License
Terms of Service
Resource Areas
1

Authentication & Security 1

Klaviyo Events API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (Klaviyo-API-Key). By default, every request must be authenticated.

  • Klaviyo-API-Key — Private key authentication for /api/ endpoints is performed by setting the Authorization header to Klaviyo-API-Key your-private-api-key For more information pl…

Paths & Operations 8

Across 7 paths, the API surfaces 8 operations — 6 GET, 2 POST. Each is listed below with its method, path, parameters, and response codes.

Events 8

events

GET
/api/events
Get Events
get_events 9 params → 2004XX5XX
POST
/api/events
Create Event
create_event 1 param body → 2024XX5XX
GET
/api/events/{id}
Get Event
get_event 6 params → 2004XX5XX
POST
/api/event-bulk-create-jobs
Bulk Create Events
bulk_create_events 1 param body → 2024XX5XX
GET
/api/events/{id}/metric
Get Metric for Event
get_metric_for_event 3 params → 2004XX5XX
GET
/api/events/{id}/relationships/metric
Get Metric ID for Event
get_metric_id_for_event 2 params → 2004XX5XX
GET
/api/events/{id}/profile
Get Profile for Event
get_profile_for_event 4 params → 2004XX5XX
GET
/api/events/{id}/relationships/profile
Get Profile ID for Event
get_profile_id_for_event 2 params → 2004XX5XX

Schemas 54

The contract defines 54 schemas that model the data the API accepts and returns. The most detailed are PredictiveAnalytics (10 properties), ProfileLocation (10 properties), EmailMarketing (10 properties), WhatsappTransactionalChannel (8 properties). Each schema is shown below with its type and property counts.

PushTokenEnum
string
GetMetricResponse
object
2 properties 1 required
EventProfileCreateQueryResourceObject
object
3 properties 2 required
EventsBulkCreateQueryResourceObject
object
2 properties 2 required
SMSTransactional
object
6 properties 2 required
EmailMarketing
object
10 properties 2 required
CampaignMessageEnum
string
WhatsappTransactionalChannel
object
8 properties 3 required
BaseEventCreateQueryBulkEntryResourceObject
object
2 properties 2 required
ListEnum
string
EventResponseObjectResource
object
5 properties 4 required
GetProfileResponse
object
2 properties 1 required
GetEventMetricRelationshipResponse
object
2 properties 1 required
Subscriptions
object
4 properties
EmailMarketingListSuppression
object
3 properties 3 required
EventsBulkCreateJob
object
1 property 1 required
PredictiveAnalytics
object
10 properties
SMSMarketing
object
6 properties 2 required
AttributionResponseObjectResource
object
4 properties 3 required
GetEventResponseCompoundDocument
object
3 properties 1 required
WhatsappChannel
object
3 properties
PushChannel
object
1 property
OnsiteProfileMeta
object
2 properties
AttributionEnum
string
ProfileEnum
string
ProfileResponseObjectResource
object
5 properties 3 required
PatchIdentifiers
object
2 properties
EventBulkCreateEnum
string
SMSChannel
object
2 properties
OnsiteProfileCreateQueryResourceObject
object
4 properties 2 required
GetEventProfileRelationshipResponse
object
2 properties 1 required
FlowEnum
string
CampaignEnum
string
EmailChannel
object
1 property
FlowMessageEnum
string
MetricResponseObjectResource
object
5 properties 4 required
MetricCreateQueryResourceObject
object
2 properties 2 required
EventCreateQueryV2ResourceObject
object
2 properties 2 required
PushMarketing
object
3 properties 2 required
EventCreateQueryV2
object
1 property 1 required
WhatsappMarketingChannel
object
8 properties 3 required
MetricEnum
string
SegmentEnum
string
EventsBulkCreateJobResourceObject
object
2 properties 2 required
EventEnum
string
WhatsappConversationalChannel
object
8 properties 3 required
EmailMarketingSuppression
object
2 properties 2 required
GetEventResponseCollectionCompoundDocument
object
3 properties 1 required
ObjectLinks
object
1 property 1 required
CollectionLinks
object
5 properties 1 required
ProfileLocation
object
10 properties
ProfileMetaPatchProperties
object
3 properties
EventBulkCreateJobEnum
string
RelationshipLinks
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

klaviyo-events-api-openapi.yml Raw ↑

Other APIs Klaviyo publishes across the network.

Klaviyo Accounts API
Klaviyo Campaigns API
Klaviyo Catalogs API
Klaviyo Client API
Klaviyo Conversations API
Klaviyo Coupons API
Klaviyo Custom Objects API
Klaviyo Data Privacy API
Klaviyo Flows API
Klaviyo Forms API
Klaviyo Images API
Klaviyo Lists API