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 Client 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 Client. 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 11 operations across 10 paths, and defines 78 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.

11 operations 10 paths 78 schemas 3 GET8 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 Client 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 11

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

Client 11

client

GET
/client/review-values-reports
Get Client Review Values Reports
get_client_review_values_reports 9 params → 2004XX5XX
GET
/client/reviews
Get Client Reviews
get_client_reviews 7 params → 2004XX5XX
POST
/client/reviews
Create Client Review
create_client_review 2 params body → 2024XX5XX
GET
/client/geofences
Get Client Geofences
get_client_geofences 6 params → 2004XX5XX
POST
/client/subscriptions
Create Client Subscription
create_client_subscription 2 params body → 2024XX5XX
POST
/client/push-tokens
Create or Update Client Push Token
create_client_push_token 2 params body → 2024XX5XX
POST
/client/push-token-unregister
Unregister Client Push Token
unregister_client_push_token 2 params body → 2024XX5XX
POST
/client/events
Create Client Event
create_client_event 2 params body → 2024XX5XX
POST
/client/profiles
Create or Update Client Profile
create_client_profile 2 params body → 2024XX5XX
POST
/client/event-bulk-create
Bulk Create Client Events
bulk_create_client_events 2 params body → 2024XX5XX
POST
/client/back-in-stock-subscriptions
Create Client Back In Stock Subscription
create_client_back_in_stock_subscription 2 params body → 2024XX5XX

Schemas 78

The contract defines 78 schemas that model the data the API accepts and returns. The most detailed are PushTokenDeviceMetadata (12 properties), DeviceMetadata (12 properties), ProfileLocation (10 properties), PushTokenEntry (6 properties). Each schema is shown below with its type and property counts.

ReviewValuesReportResponseObjectResource
object
4 properties 4 required
EventProfileCreateQueryResourceObject
object
3 properties 2 required
EventsBulkCreateQuery
object
1 property 1 required
ListEnum
string
GeofenceResponseObjectResource
object
4 properties 4 required
ClientBISSubscriptionCreateQueryResourceObject
object
3 properties 3 required
ProfileUpsertQueryResourceObject
object
4 properties 2 required
EventBulkCreateEnum
string
ProfileEnum
string
ClientBISSubscriptionCreateQuery
object
1 property 1 required
RejectReasonOther
object
2 properties 1 required
OnsiteSubscriptionCreateQueryResourceObject
object
3 properties 3 required
ReviewEnum
string
MetricCreateQueryResourceObject
object
2 properties 2 required
RejectReasonProfanity
object
1 property 1 required
StatisticsDTO
object
6 properties
ReviewCreateDTO
object
1 property 1 required
ObjectLinks
object
1 property 1 required
GetReviewValuesReportResponseCollection
object
2 properties 1 required
ReviewProductDTO
object
4 properties 2 required
RejectReasonUnrelated
object
1 property 1 required
OnsiteProfileCreateQueryResourceObject
object
4 properties 2 required
ProfileMetaPatchProperties
object
3 properties
OnsiteProfileCreateQuery
object
1 property 1 required
PushTokenEnum
string
ReviewPublicReply
object
3 properties 3 required
ReviewProductExternalId
object
2 properties 2 required
GroupingProduct
object
1 property 1 required
BaseEventCreateQueryBulkEntryResourceObject
object
2 properties 2 required
ProfileMeta
object
2 properties
PushTokenEntry
object
6 properties 3 required
ClientReviewResponseDTOObjectResource
object
4 properties 4 required
BackInStockSubscriptionEnum
string
ReviewStatusPublished
object
1 property 1 required
RejectReasonPrivateInformation
object
1 property 1 required
SMSSubscriptionParameters
object
2 properties
ReviewValueReportGrouping
object
2 properties 2 required
GetGeofenceResponseCollection
object
2 properties 1 required
CatalogVariantEnum
string
PushTokenUnregisterEnum
string
EventsBulkCreateQueryResourceObject
object
2 properties 2 required
SubscriptionEnum
string
ProfileUpsertQueryWithSubscriptionsResourceObject
object
3 properties 2 required
RejectReasonMisleading
object
1 property 1 required
PushSubscriptionParameters
object
3 properties 1 required
ReviewValuesReportEnum
string
GeofenceEnum
string
OnsiteProfileMeta
object
2 properties
PatchIdentifiers
object
2 properties
PushTokenCreateQueryResourceObject
object
2 properties 2 required
PushTokenUnregisterQueryResourceObject
object
2 properties 2 required
SubscriptionChannels
object
4 properties
EventCreateQueryV2
object
1 property 1 required
MetricEnum
string
EventEnum
string
CustomQuestionDTO
object
2 properties 2 required
ReviewStatusPending
object
1 property 1 required
ReviewStatusUnpublished
object
1 property 1 required
ReviewCreateDTOResourceObject
object
3 properties 2 required
PushTokenCreateQuery
object
1 property 1 required
ProfileLocation
object
10 properties
ProfileIdentifierDTOResourceObject
object
3 properties 2 required
GroupingCompany
object
1 property 1 required
PushTokenDeviceMetadata
object
12 properties
ReviewStatusRejected
object
2 properties 2 required
PushTokenUnregisterQuery
object
1 property 1 required
PushProfileUpsertQueryResourceObject
object
3 properties 2 required
DeviceMetadata
object
12 properties
OrderEnum
string
EventCreateQueryV2ResourceObject
object
2 properties 2 required
OnsiteSubscriptionCreateQuery
object
1 property 1 required
WhatsAppSubscriptionParameters
object
2 properties
EmailSubscriptionParameters
object
1 property 1 required
GetClientReviewResponseDTOCollection
object
2 properties 1 required
SubscriptionParameters
object
2 properties 1 required
CollectionLinks
object
5 properties 1 required
ReviewStatusFeatured
object
1 property 1 required
RejectReasonFake
object
1 property 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

klaviyo-client-api-openapi.yml Raw ↑

Other APIs Klaviyo publishes across the network.

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