Home / Servers / Stripe API / post_promotion_codes
Create a promotion code
An MCP tool from the Stripe API server, hosted on mcp.hjlabs.in.
Create a promotion code A promotion code points to an underlying promotion. You can optionally restrict the code to a specific customer, redemption limit, and expiration date. [POST /v1/promotion_codes]
Name on the gateway: stripe_api__post_promotion_codes · may change things.
Parameters
| Name | Type | Description |
|---|---|---|
active | boolean | Whether the promotion code is currently active. |
code | string | The customer-facing code. Regardless of case, this code must be unique across… |
customer | string | The customer who can use this promotion code. If not set, all customers can… |
customer_account | string | The account representing the customer who can use this promotion code. If not… |
expand | array | Specifies which fields in the response should be expanded. |
expires_at | integer | The timestamp at which this promotion code will expire. If the coupon has… |
max_redemptions | integer | A positive integer specifying the number of times the promotion code can be… |
metadata | object | Set of key-value pairs that you can attach to an object. This can be useful… |
promotion required | object | The promotion referenced by this promotion code. |
restrictions | object | Settings that restrict the redemption of the promotion code. |
How to call it
Through the Smart Gateway, any client can run it by name with call_tool, or let the gateway find it with search_tools:
{
"name": "stripe_api__post_promotion_codes",
"arguments": {
"promotion": "…"
}
}Or connect the Stripe API server directly, which lists 606 tools including this one:
claude mcp add --transport http hj-stripe-api https://mcp.hjlabs.in/mcp/stripe-api \
--header "Authorization: Bearer YOUR_API_KEY"Try asking
Use the create a promotion code tool with active set to ….