v69

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-011221331.4 MB
Promotional Entitlements

Create a promotional entitlements

Grants promotional entitlements to a customer, providing feature access outside their subscription. Entitlements can be time-limited or permanent.

post/api/v1/customers/{id}/promotional-entitlements

Path parameters

idstring required

The unique identifier of the entity

Headers

X-ACCOUNT-IDstring

Account ID — optional when authenticating with a user JWT (Bearer token); falls back to the user's first membership. Ignored for API-key auth.

X-ENVIRONMENT-IDstring

Environment ID — required when authenticating with a user JWT (Bearer token) on environment-scoped endpoints. Ignored for API-key auth (env is intrinsic to the key).

Request body

Response

The granted promotional entitlement objects.