{"command":{"effect":"write","timeoutSeconds":30,"inputSchema":{"type":"object","description":"Creates a new coupon.<br><br>*Rate limits*:<br>Burst: `3/s`<br>Steady: `60/m`\n\n**Scopes:**\n`coupons:write`\n\n[OpenAPI Spec](https://raw.githubusercontent.com/klaviyo/openapi/main/openapi/stable/apis/create_coupon.json)","properties":{"query":{"type":"object","properties":{"fields[coupon]":{"type":"array","items":{"type":"string","enum":["assigner_configuration","assigner_configuration.unused_expired","assigner_configuration.used","description","external_id","id","monitor_configuration"]},"description":"For more information please visit https://developers.klaviyo.com/en/v2026-10-15/reference/api-overview#sparse-fieldsets"}},"required":[],"additionalProperties":false},"headers":{"type":"object","properties":{"revision":{"type":"string","default":"2026-10-15","enum":["2026-10-15"],"description":"API endpoint revision (format: YYYY-MM-DD[.suffix])"}},"required":["revision"],"additionalProperties":false},"body":{"$ref":"#/definitions/CouponCreateQuery"}},"required":["headers","body"],"additionalProperties":false,"definitions":{"CouponCreateQuery":{"type":"object","properties":{"data":{"$ref":"#/definitions/CouponCreateQueryResourceObject"}},"required":["data"]},"CouponCreateQueryResourceObject":{"type":"object","properties":{"type":{"$ref":"#/definitions/CouponEnum"},"attributes":{"type":"object","properties":{"external_id":{"description":"This is the id that is stored in an integration such as Shopify or Magento.","type":"string","examples":["10OFF"]},"description":{"description":"A description of the coupon.","type":["string","null"],"examples":["10% off for purchases over $50"]},"monitor_configuration":{"description":"The monitor configuration for the coupon.","type":["object","null"],"examples":[{"low_balance_threshold":500}]},"assigner_configuration":{"$ref":"#/definitions/CouponAssignerConfiguration"}},"required":["external_id"]}},"required":["type","attributes"]},"CouponEnum":{"type":"string","enum":["coupon"]},"CouponAssignerConfiguration":{"type":"object","properties":{"used":{"description":"Controls when a new coupon code is issued relative to the customer's existing code being used.","type":"string","enum":["ALWAYS_ASSIGN","ASSIGN_IF_EXPIRED","NEVER_ASSIGN"],"examples":["ALWAYS_ASSIGN"]},"unused_expired":{"description":"Controls when a new coupon code is issued relative to the customer's existing, unused code expiring.","type":"string","enum":["ALWAYS_ASSIGN","NEVER_ASSIGN"],"examples":["ALWAYS_ASSIGN"]}},"required":["used","unused_expired"]}}},"name":"Create Coupon","id":"klaviyo.create_coupon","example":{"headers":{"revision":"2026-10-15"},"body":{"data":{"type":"coupon","attributes":{"external_id":"10OFF"}}}},"maxRequests":1,"summary":false}}