post
https://api.vcita.biz/v3/license/subscriptions
Overview
Create a new Subscription for a business. Supports discounted and free plans using coupons.
Available for Staff tokens.
Token Permissions
| Token Type | Allowed | Restrictions |
|---|---|---|
| Staff | Yes | Cannot set custom pricing. For external payment type offerings, must use a Staff token created by a Directory token. |
| Directory | No | Must create a Staff token first via POST /platform/v1/tokens |
| Internal | No | Must create a Staff token first |
| Billing App | Yes | Cannot set custom pricing |
| Regular App | No | Not allowed |
Important: External Payment Type Offerings
Offerings with payment_type = external require a Staff token created by a Directory token:
- Use
POST /platform/v1/tokenswith a Directory token to create a Staff token for the target business. - Use that Staff token to call this endpoint.
The buyer_uid in the subscription is automatically derived from the authenticated Staff token's identity.