Klaviyo

Klaviyo Coupons API

coupons

GitHub OpenAPI
Business capability
Discount & Promotion Management BC-440.30

Operations 17

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/coupons List coupons in the account · Get Coupons #
Ask an LLM
“What coupons have I set up in Klaviyo?”
“Can I page through my coupons a few at a time?”
Tell an agent
List all my coupons.
Show my coupons {page_size} per page.
POST /api/coupons Create a coupon · Create Coupon #
Ask an LLM
“How do I set up a new coupon that I can generate unique codes for?”
“What do I need to provide when creating a coupon?”
Tell an agent
Create a coupon named {coupon}.
Set up a new coupon with these details: {coupon}.
GET /api/coupons/{id} Get one coupon by ID · Get Coupon #
Ask an LLM
“How can I look up a single coupon's settings?”
“Can I fetch a coupon by its ID?”
Tell an agent
Get coupon {coupon_id}.
Show the settings of coupon {coupon_id}.
PATCH /api/coupons/{id} Update a coupon · Update Coupon #
Ask an LLM
“Can I change the description of an existing coupon?”
“What's the way to edit a coupon after it's created?”
Tell an agent
Update coupon {coupon_id} with {changes}.
Change the description of coupon {coupon_id} to {changes}.
DELETE /api/coupons/{id} Delete a coupon · Delete Coupon #
Ask an LLM
“How do I remove a coupon I no longer offer?”
“Can I delete a coupon by its ID?”
Tell an agent destructive · confirm first
Delete coupon {coupon_id}.
Remove the retired coupon {coupon_id}.
GET /api/coupon-codes List coupon codes by coupon or profile · Get Coupon Codes #
Ask an LLM
“Which coupon codes have been issued to a particular customer?”
“Why do I need to filter by coupon or profile to list coupon codes?”
Tell an agent
List coupon codes matching {filter}.
Find the coupon codes assigned to the profile in {filter}.
POST /api/coupon-codes Create a single coupon code · Create Coupon Code #
Ask an LLM
“How do I add one unique code to an existing coupon?”
“Is creating a single coupon code immediate or queued?”
Tell an agent
Create coupon code {coupon_code} for its coupon.
Add a single unique code to a coupon: {coupon_code}.
GET /api/coupon-codes/{id} Get one coupon code by ID · Get Coupon Code #
Ask an LLM
“What's the status and expiry of a specific coupon code?”
“Can I see which profile a coupon code is assigned to?”
Tell an agent
Get coupon code {code_id}.
Show coupon code {code_id} with its {include}.
PATCH /api/coupon-codes/{id} Update a coupon code's status or expiry · Update Coupon Code #
Ask an LLM
“Can I change when a coupon code expires?”
“Which fields on a coupon code can be updated?”
Tell an agent
Update coupon code {code_id} with {changes}.
Set a new expiration date on coupon code {code_id}: {changes}.
DELETE /api/coupon-codes/{id} Delete a coupon code · Delete Coupon Code #
Ask an LLM
“How do I remove a coupon code that was never used?”
“Can I delete a coupon code that's already assigned to a profile?”
Tell an agent destructive · confirm first
Delete coupon code {code_id}.
Remove the unassigned coupon code {code_id}.
GET /api/coupon-code-bulk-create-jobs List bulk coupon code creation jobs · Get Bulk Create Coupon Code Jobs #
Ask an LLM
“Where can I see all my bulk coupon code upload jobs?”
“Can I filter coupon code jobs by status?”
Tell an agent
List all bulk coupon code creation jobs.
Show coupon code jobs matching {filter}.
POST /api/coupon-code-bulk-create-jobs Bulk create up to 1,000 coupon codes · Bulk Create Coupon Codes #
Ask an LLM
“How many coupon codes can I upload in one bulk job?”
“What's the limit on how many bulk code jobs can be queued at once?”
Tell an agent
Bulk create these coupon codes: {coupon_codes}.
Start a job to upload {coupon_codes} to a coupon.
GET /api/coupon-code-bulk-create-jobs/{job_id} Check a bulk coupon code job · Get Bulk Create Coupon Codes Job #
Ask an LLM
“Has my bulk coupon code upload finished?”
“How many codes succeeded or failed in a specific bulk job?”
Tell an agent
Get bulk coupon code job {job_id}.
Check the progress of code upload job {job_id}.
GET /api/coupon-codes/{id}/coupon Get the coupon a code belongs to · Get Coupon For Coupon Code #
Ask an LLM
“Which coupon does a given code belong to?”
“Can I get the full parent coupon from a code ID?”
Tell an agent
Get the coupon that code {code_id} belongs to.
Show the full parent coupon of code {code_id}.
GET /api/coupon-codes/{id}/relationships/coupon Get the coupon ID for a code · Get Coupon ID for Coupon Code #
Ask an LLM
“Can I fetch only the parent coupon ID for a coupon code?”
“What coupon relationship does a code carry?”
Tell an agent
Get just the coupon ID for code {code_id}.
Return the coupon relationship of code {code_id}.
GET /api/coupons/{id}/coupon-codes List codes issued for a coupon · Get Coupon Codes for Coupon #
Ask an LLM
“What unique codes exist under one coupon?”
“Can I filter a coupon's codes by status or expiry?”
Tell an agent
List the codes issued under coupon {coupon_id}.
Show codes for coupon {coupon_id} matching {filter}.
GET /api/coupons/{id}/relationships/coupon-codes Get code IDs for a coupon · Get Coupon Code IDs for Coupon #
Ask an LLM
“Can I get only the IDs of codes under a coupon?”
“What coupon-code relationships does a coupon have?”
Tell an agent
Get just the code IDs for coupon {coupon_id}.
Return coupon-code relationships of coupon {coupon_id}.

Documentation

📖
Documentation
https://developers.klaviyo.com/
📖
Authentication
https://developers.klaviyo.com/en/docs/authenticate_
📖
RateLimits
https://developers.klaviyo.com/en/docs/rate_limits_and_error_handling

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/klaviyo/refs/heads/main/openapi/klaviyo-coupons-api-openapi.yml
⚙
AsyncAPI
https://raw.githubusercontent.com/api-evangelist/klaviyo/refs/heads/main/asyncapi/klaviyo-webhooks-asyncapi.yaml

Other Resources

🔗
Reference
https://developers.klaviyo.com/en/reference/api_overview
🔗
Versioning
https://developers.klaviyo.com/en/docs/api_versioning_and_deprecation_policy
🔗
ChangeLog
https://developers.klaviyo.com/en/docs/changelog_
🔗
SDKs
https://developers.klaviyo.com/en/docs/sdk_overview
🔗
GitHub
https://github.com/klaviyo/openapi
🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/klaviyo/refs/heads/main/overlays/klaviyo-coupons-api-overlay.yaml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/klaviyo:klaviyo-coupons-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

klaviyo-coupons-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Klaviyo Coupons API
  version: '2026-04-15'
  description: The Klaviyo REST API. Please visit https://developers.klaviyo.com for more details.
  contact:
    name: Klaviyo Developer Experience Team
    email: developers@klaviyo.com
    url: https://developers.klaviyo.com
  termsOfService: https://www.klaviyo.com/legal/api-terms
  license:
    name: License
    url: https://www.klaviyo.com/legal
servers:
- url: https://a.klaviyo.com
  description: Production
security:
- Klaviyo-API-Key: []
tags:


# --- truncated at 32 KB (66 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/klaviyo/refs/heads/main/openapi/klaviyo-coupons-api-openapi.yml