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 Webhooks 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 Webhooks. 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 7 operations across 4 paths, and defines 17 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.

7 operations 4 paths 17 schemas 1 DELETE4 GET1 PATCH1 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 Webhooks 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 7

Across 4 paths, the API surfaces 7 operations — 1 DELETE, 4 GET, 1 PATCH, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Webhooks 7

webhooks

GET
/api/webhooks
Get Webhooks
get_webhooks 3 params → 2004XX5XX
POST
/api/webhooks
Create Webhook
create_webhook 1 param body → 2014XX5XX
GET
/api/webhooks/{id}
Get Webhook
get_webhook 4 params → 2004XX5XX
PATCH
/api/webhooks/{id}
Update Webhook
update_webhook 2 params body → 2004XX5XX
DELETE
/api/webhooks/{id}
Delete Webhook
delete_webhook 2 params → 2044XX5XX
GET
/api/webhook-topics
Get Webhook Topics
get_webhook_topics 1 param → 2004XX5XX
GET
/api/webhook-topics/{id}
Get Webhook Topic
get_webhook_topic 2 params → 2004XX5XX

Schemas 17

The contract defines 17 schemas that model the data the API accepts and returns. The most detailed are CollectionLinks (5 properties), WebhookResponseObjectResource (5 properties), WebhookPartialUpdateQueryResourceObject (4 properties), GetWebhookResponseCollectionCompoundDocument (3 properties). Each schema is shown below with its type and property counts.

WebhookPartialUpdateQuery
object
1 property 1 required
GetWebhookResponseCompoundDocument
object
3 properties 1 required
GetWebhookResponseCollectionCompoundDocument
object
3 properties 1 required
WebhookTopicResponseObjectResource
object
3 properties 3 required
WebhookResponseObjectResource
object
5 properties 4 required
WebhookCreateQuery
object
1 property 1 required
PostWebhookResponse
object
2 properties 1 required
WebhookTopicEnum
string
WebhookPartialUpdateQueryResourceObject
object
4 properties 3 required
GetWebhookTopicResponse
object
2 properties 1 required
PatchWebhookResponse
object
2 properties 1 required
WebhookCreateQueryResourceObject
object
3 properties 3 required
WebhookEnum
string
ObjectLinks
object
1 property 1 required
CollectionLinks
object
5 properties 1 required
GetWebhookTopicResponseCollection
object
2 properties 1 required
RelationshipLinks
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

klaviyo-webhooks-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 Events API
Klaviyo Flows API
Klaviyo Forms API
Klaviyo Images API