---
title: "Apply Coupon to Subscription"
method: POST
path: "/api/v1/subscriptions/apply-coupon"
tags: ["subscriptions"]
---

# Apply Coupon to Subscription

`POST /api/v1/subscriptions/apply-coupon`

## Request

- Base URL: `https://api.seoproai.co`
- URL: `https://api.seoproai.co/api/v1/subscriptions/apply-coupon`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://dajosjnaalanhqksxrpe.supabase.co/auth/v1/authorize`, token URL `https://dajosjnaalanhqksxrpe.supabase.co/auth/v1/token`)

Apply a coupon/discount to a subscription with usage tracking

## Headers

- `X-User-Id` string, nullable
- `X-Organization-Id` string, nullable
- `Authorization` string, nullable

## Request body

- ApplyCouponRequest
  - `stripe_subscription_id` string, required
  - `coupon_id` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/seoproai/apis/seopro-ai.md) · [All operations](https://skmtc.dev/seoproai/apis/seopro-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/seoproai/apis/seopro-ai/revisions/5b4b6391ddc9?raw)