{
  "opencollection": "1.0.0",
  "info": {
    "name": "Klaviyo Accounts Coupons API",
    "version": "2026-04-15"
  },
  "request": {
    "auth": {
      "type": "apikey",
      "key": "Authorization",
      "value": "{{Authorization}}",
      "placement": "header"
    }
  },
  "items": [
    {
      "info": {
        "name": "Coupons",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "Get Coupons",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://a.klaviyo.com/api/coupons",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "fields[coupon]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              },
              {
                "name": "page[cursor]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination"
              },
              {
                "name": "page[size]",
                "value": "",
                "type": "query",
                "description": "Default: 100. Min: 1. Max: 100."
              }
            ]
          },
          "docs": "Get all coupons in an account.\n\nTo learn more, see our [Coupons API guide](https://developers.klaviyo.com/en/docs/use_klaviyos_coupons_api).<br><br>*Rate limits*:<br>Burst: `75/s`<br>Steady: `750/m`\n\n**Scopes:**\n`coupons:read`"
        },
        {
          "info": {
            "name": "Create Coupon",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://a.klaviyo.com/api/coupons",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Creates a new coupon.<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`\n\n**Scopes:**\n`coupons:write`"
        },
        {
          "info": {
            "name": "Get Coupon",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://a.klaviyo.com/api/coupons/:id",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "The internal id of a Coupon is equivalent to its external id stored within an integration."
              },
              {
                "name": "fields[coupon]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              }
            ]
          },
          "docs": "Get a specific coupon with the given coupon ID.<br><br>*Rate limits*:<br>Burst: `75/s`<br>Steady: `750/m`\n\n**Scopes:**\n`coupons:read`"
        },
        {
          "info": {
            "name": "Update Coupon",
            "type": "http"
          },
          "http": {
            "method": "PATCH",
            "url": "https://a.klaviyo.com/api/coupons/:id",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "The internal id of a Coupon is equivalent to its external id stored within an integration."
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`\n\n**Scopes:**\n`coupons:write`"
        },
        {
          "info": {
            "name": "Delete Coupon",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://a.klaviyo.com/api/coupons/:id",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "The internal id of a Coupon is equivalent to its external id stored within an integration."
              }
            ]
          },
          "docs": "Delete the coupon with the given coupon ID.<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`\n\n**Scopes:**\n`coupons:write`"
        },
        {
          "info": {
            "name": "Get Coupon Codes",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://a.klaviyo.com/api/coupon-codes",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "fields[coupon-code]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              },
              {
                "name": "fields[coupon]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              },
              {
                "name": "filter",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering<br>Allowed field(s)/operator(s):<br>`expires_at`: `greater-or-equal`, `greater-than`, `less-or-equal`, `less-than`<br>`status`: `equals`<br>`coupon.id`: `any`, `equals`<br>`profile.id`: `any`, `equals`"
              },
              {
                "name": "include",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships"
              },
              {
                "name": "page[cursor]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination"
              },
              {
                "name": "page[size]",
                "value": "",
                "type": "query",
                "description": "Default: 100. Min: 1. Max: 100."
              }
            ]
          },
          "docs": "Gets a list of coupon codes associated with a coupon/coupons or a profile/profiles.\n\nA coupon/coupons or a profile/profiles must be provided as required filter params.<br><br>*Rate limits*:<br>Burst: `350/s`<br>Steady: `3500/m`\n\n**Scopes:**\n`coupon-codes:read`"
        },
        {
          "info": {
            "name": "Create Coupon Code",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://a.klaviyo.com/api/coupon-codes",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Synchronously creates a coupon code for the given coupon.<br><br>*Rate limits*:<br>Burst: `350/s`<br>Steady: `3500/m`\n\n**Scopes:**\n`coupon-codes:write`"
        },
        {
          "info": {
            "name": "Get Coupon Code",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://a.klaviyo.com/api/coupon-codes/:id",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "The id of a coupon code is a combination of its unique code and the id of the coupon it is associated with."
              },
              {
                "name": "fields[coupon-code]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              },
              {
                "name": "fields[coupon]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              },
              {
                "name": "include",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships"
              }
            ]
          },
          "docs": "Returns a Coupon Code specified by the given identifier.<br><br>*Rate limits*:<br>Burst: `350/s`<br>Steady: `3500/m`\n\n**Scopes:**\n`coupon-codes:read`"
        },
        {
          "info": {
            "name": "Update Coupon Code",
            "type": "http"
          },
          "http": {
            "method": "PATCH",
            "url": "https://a.klaviyo.com/api/coupon-codes/:id",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "The id of a coupon code is a combination of its unique code and the id of the coupon it is associated with."
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Updates a coupon code specified by the given identifier synchronously. We allow updating the 'status' and\n'expires_at' of coupon codes.<br><br>*Rate limits*:<br>Burst: `350/s`<br>Steady: `3500/m`\n\n**Scopes:**\n`coupon-codes:write`"
        },
        {
          "info": {
            "name": "Delete Coupon Code",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://a.klaviyo.com/api/coupon-codes/:id",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "The id of a coupon code is a combination of its unique code and the id of the coupon it is associated with."
              }
            ]
          },
          "docs": "Deletes a coupon code specified by the given identifier synchronously. If a profile has been assigned to the\ncoupon code, an exception will be raised<br><br>*Rate limits*:<br>Burst: `350/s`<br>Steady: `3500/m`\n\n**Scopes:**\n`coupon-codes:write`"
        },
        {
          "info": {
            "name": "Get Bulk Create Coupon Code Jobs",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://a.klaviyo.com/api/coupon-code-bulk-create-jobs",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "fields[coupon-code-bulk-create-job]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              },
              {
                "name": "filter",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering<br>Allowed field(s)/operator(s):<br>`status`: `equals`"
              },
              {
                "name": "page[cursor]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination"
              }
            ]
          },
          "docs": "Get all coupon code bulk create jobs.\n\nReturns a maximum of 100 jobs per request.<br><br>*Rate limits*:<br>Burst: `75/s`<br>Steady: `750/m`\n\n**Scopes:**\n`coupon-codes:read`"
        },
        {
          "info": {
            "name": "Bulk Create Coupon Codes",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://a.klaviyo.com/api/coupon-code-bulk-create-jobs",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Create a coupon-code-bulk-create-job to bulk create a list of coupon codes.\n\nMax number of coupon codes per job we allow for is 1000.\nMax number of jobs queued at once we allow for is 100.<br><br>*Rate limits*:<br>Burst: `75/s`<br>Steady: `750/m`\n\n**Scopes:**\n`coupon-codes:write`"
        },
        {
          "info": {
            "name": "Get Bulk Create Coupon Codes Job",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://a.klaviyo.com/api/coupon-code-bulk-create-jobs/:job_id",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "job_id",
                "value": "",
                "type": "path",
                "description": "ID of the job to retrieve."
              },
              {
                "name": "fields[coupon-code-bulk-create-job]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              },
              {
                "name": "fields[coupon-code]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              },
              {
                "name": "include",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#relationships"
              }
            ]
          },
          "docs": "Get a coupon code bulk create job with the given job ID.<br><br>*Rate limits*:<br>Burst: `75/s`<br>Steady: `750/m`\n\n**Scopes:**\n`coupon-codes:read`"
        },
        {
          "info": {
            "name": "Get Coupon For Coupon Code",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://a.klaviyo.com/api/coupon-codes/:id/coupon",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "The ID of the coupon to look up the relationship of."
              },
              {
                "name": "fields[coupon]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              }
            ]
          },
          "docs": "Get the coupon associated with a given coupon code ID.<br><br>*Rate limits*:<br>Burst: `75/s`<br>Steady: `750/m`\n\n**Scopes:**\n`coupons:read`"
        },
        {
          "info": {
            "name": "Get Coupon ID for Coupon Code",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://a.klaviyo.com/api/coupon-codes/:id/relationships/coupon",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "The ID of the coupon to look up the relationship of."
              }
            ]
          },
          "docs": "Gets the coupon relationship associated with the given coupon code id<br><br>*Rate limits*:<br>Burst: `75/s`<br>Steady: `750/m`\n\n**Scopes:**\n`coupons:read`"
        },
        {
          "info": {
            "name": "Get Coupon Codes for Coupon",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://a.klaviyo.com/api/coupons/:id/coupon-codes",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "The ID of the coupon to look up the relationship of."
              },
              {
                "name": "fields[coupon-code]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets"
              },
              {
                "name": "filter",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering<br>Allowed field(s)/operator(s):<br>`expires_at`: `greater-or-equal`, `greater-than`, `less-or-equal`, `less-than`<br>`status`: `equals`<br>`coupon.id`: `any`, `equals`<br>`profile.id`: `any`, `equals`"
              },
              {
                "name": "page[cursor]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination"
              },
              {
                "name": "page[size]",
                "value": "",
                "type": "query",
                "description": "Default: 100. Min: 1. Max: 100."
              }
            ]
          },
          "docs": "Gets a list of coupon codes associated with the given coupon id<br><br>*Rate limits*:<br>Burst: `75/s`<br>Steady: `750/m`\n\n**Scopes:**\n`coupon-codes:read`"
        },
        {
          "info": {
            "name": "Get Coupon Code IDs for Coupon",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://a.klaviyo.com/api/coupons/:id/relationships/coupon-codes",
            "headers": [
              {
                "name": "revision",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "id",
                "value": "",
                "type": "path",
                "description": "The ID of the coupon to look up the relationship of."
              },
              {
                "name": "filter",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#filtering<br>Allowed field(s)/operator(s):<br>`expires_at`: `greater-or-equal`, `greater-than`, `less-or-equal`, `less-than`<br>`status`: `equals`<br>`coupon.id`: `any`, `equals`<br>`profile.id`: `any`, `equals`"
              },
              {
                "name": "page[cursor]",
                "value": "",
                "type": "query",
                "description": "For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination"
              },
              {
                "name": "page[size]",
                "value": "",
                "type": "query",
                "description": "Default: 100. Min: 1. Max: 100."
              }
            ]
          },
          "docs": "Gets a list of coupon code relationships associated with the given coupon id<br><br>*Rate limits*:<br>Burst: `75/s`<br>Steady: `750/m`\n\n**Scopes:**\n`coupon-codes:read`"
        }
      ]
    }
  ],
  "bundled": true
}