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 Coupons 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 Coupons. 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 17 operations across 10 paths, and defines 36 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.

17 operations 10 paths 36 schemas 2 DELETE10 GET2 PATCH3 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 Coupons 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 17

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

Coupons 17

coupons

GET
/api/coupons
Get Coupons
get_coupons 4 params → 2004XX5XX
POST
/api/coupons
Create Coupon
create_coupon 1 param body → 2014XX5XX
GET
/api/coupons/{id}
Get Coupon
get_coupon 3 params → 2004XX5XX
PATCH
/api/coupons/{id}
Update Coupon
update_coupon 2 params body → 2004XX5XX
DELETE
/api/coupons/{id}
Delete Coupon
delete_coupon 2 params → 2044XX5XX
GET
/api/coupon-codes
Get Coupon Codes
get_coupon_codes 7 params → 2004XX5XX
POST
/api/coupon-codes
Create Coupon Code
create_coupon_code 1 param body → 2004XX5XX
GET
/api/coupon-codes/{id}
Get Coupon Code
get_coupon_code 5 params → 2004XX5XX
PATCH
/api/coupon-codes/{id}
Update Coupon Code
update_coupon_code 2 params body → 2004XX5XX
DELETE
/api/coupon-codes/{id}
Delete Coupon Code
delete_coupon_code 2 params → 2044XX5XX
GET
/api/coupon-code-bulk-create-jobs
Get Bulk Create Coupon Code Jobs
get_bulk_create_coupon_code_jobs 4 params → 2004XX5XX
POST
/api/coupon-code-bulk-create-jobs
Bulk Create Coupon Codes
bulk_create_coupon_codes 1 param body → 2024XX5XX
GET
/api/coupon-code-bulk-create-jobs/{job_id}
Get Bulk Create Coupon Codes Job
get_bulk_create_coupon_codes_job 5 params → 2004XX5XX
GET
/api/coupon-codes/{id}/coupon
Get Coupon For Coupon Code
get_coupon_for_coupon_code 3 params → 2004XX5XX
GET
/api/coupon-codes/{id}/relationships/coupon
Get Coupon ID for Coupon Code
get_coupon_id_for_coupon_code 2 params → 2004XX5XX
GET
/api/coupons/{id}/coupon-codes
Get Coupon Codes for Coupon
get_coupon_codes_for_coupon 6 params → 2004XX5XX
GET
/api/coupons/{id}/relationships/coupon-codes
Get Coupon Code IDs for Coupon
get_coupon_code_ids_for_coupon 5 params → 2004XX5XX

Schemas 36

The contract defines 36 schemas that model the data the API accepts and returns. The most detailed are APIJobErrorPayload (5 properties), CouponCodeCreateJobResponseObjectResource (5 properties), CouponCodeResponseObjectResource (5 properties), CollectionLinks (5 properties). Each schema is shown below with its type and property counts.

GetCouponCodeResponseCollectionCompoundDocument
object
3 properties 1 required
CouponCodeCreateQuery
object
1 property 1 required
CouponCodeEnum
string
CouponCodeCreateQueryResourceObject
object
3 properties 3 required
CouponEnum
string
CouponCreateQueryResourceObject
object
2 properties 2 required
GetCouponResponse
object
2 properties 1 required
CouponCodeCreateJobCreateQueryResourceObject
object
2 properties 2 required
CouponCodeUpdateQuery
object
1 property 1 required
CouponCodeCreateJobCreateQuery
object
1 property 1 required
ErrorSource
object
1 property
CouponCodeUpdateQueryResourceObject
object
3 properties 3 required
APIJobErrorPayload
object
5 properties 5 required
CouponCreateQuery
object
1 property 1 required
PostCouponResponse
object
2 properties 1 required
PatchCouponCodeResponse
object
2 properties 1 required
ProfileEnum
string
GetCouponCodeResponseCollection
object
2 properties 1 required
PatchCouponResponse
object
2 properties 1 required
GetCouponCodeCouponRelationshipResponse
object
2 properties 1 required
PostCouponCodeCreateJobResponse
object
2 properties 1 required
GetCouponCodeResponseCompoundDocument
object
3 properties 1 required
GetCouponResponseCollection
object
2 properties 1 required
PostCouponCodeResponse
object
2 properties 1 required
CouponUpdateQueryResourceObject
object
3 properties 3 required
GetCouponCodesRelationshipsResponseCollection
object
2 properties 1 required
GetCouponCodeCreateJobResponseCollectionCompoundDocument
object
2 properties 1 required
ObjectLinks
object
1 property 1 required
GetCouponCodeCreateJobResponseCompoundDocument
object
3 properties 1 required
CouponUpdateQuery
object
1 property 1 required
CouponCodeCreateJobResponseObjectResource
object
5 properties 4 required
CollectionLinks
object
5 properties 1 required
CouponCodeResponseObjectResource
object
5 properties 4 required
CouponCodeBulkCreateJobEnum
string
CouponResponseObjectResource
object
4 properties 4 required
RelationshipLinks
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

klaviyo-coupons-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 Custom Objects API
Klaviyo Data Privacy API
Klaviyo Events API
Klaviyo Flows API
Klaviyo Forms API
Klaviyo Images API
Klaviyo Lists API