How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
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 Event. 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.2.0, 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.2.0
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 ProfileLocation (10 properties), EmailMarketing (10 properties), PredictiveAnalytics (10 properties), WhatsappMarketingChannel (8 properties). Each schema is shown below with its type and property counts.

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

This is an independent, third-party profile of Klaviyo Events API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.