Skip to main content
POST
Grant an entitlement
This endpoint requires a Secret Key (sk_ prefix). Never expose it in client-side code.

Authorizations

Authorization
string
header
required

Use your Secret Key (prefixed with sk_) from the Qonversion dashboard (Project Settings -> Project Keys -> Secret Key). Sandbox secret keys are prefixed with test_sk_.

Never expose the secret key in client-side code.

Path Parameters

user_id
string
required

Qonversion User ID

Body

application/json
id
string
required

Entitlement ID

expires
integer<int64>
required

Unix timestamp (seconds) when entitlement expires. Must be in the future.

Response

Entitlement granted

id
string

Entitlement identifier

Example:

"plus"

active
boolean

Whether the user currently has the entitlement

Example:

true

started
integer

Unix epoch seconds when entitlement was activated

Example:

1652438020

expires
integer

Unix epoch seconds when entitlement expires

Example:

1654215637

source
enum<string>

Purchase origin

Available options:
appstore,
playstore,
stripe,
paddle,
manual,
unknown
Example:

"appstore"

product
object