Skip to main content
POST
/
products
Create a product
curl --request POST \
  --url https://api.qonversion.io/v4/products \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "premium_monthly",
  "type": "<string>",
  "duration": "<string>",
  "apple_product_id": "<string>",
  "google_product_id": "<string>",
  "google_base_plan_id": "<string>",
  "stripe_product_id": "<string>"
}
'
{
  "object": "product",
  "id": "premium_monthly",
  "url": "/v4/products/premium_monthly",
  "created_at": "2025-09-15T12:30:00Z",
  "updated_at": "2025-11-03T10:26:40Z",
  "type": "<string>",
  "duration": "<string>",
  "apple_product_id": "<string>",
  "google_product_id": "<string>",
  "google_base_plan_id": "<string>",
  "stripe_product_id": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication using the project Secret Key (prefixed with sk_, or test_sk_ for sandbox). All v4 public endpoints require the Secret Key — see Authentication. Never expose the Secret Key in client-side code.

Body

application/json
​
id
string
required

Unique product identifier.

Example:

"premium_monthly"

​
type
string | null

Product type. Mirrors dashboard labels.

​
duration
string | null

Subscription duration in ISO 8601 format. Allowed only for subscription_with_promo or subscription.

​
apple_product_id
string | null
​
google_product_id
string | null
​
google_base_plan_id
string | null
​
stripe_product_id
string | null

Response

Created product

​
object
enum<string>
required
Available options:
product
​
id
string
required

Unique product identifier.

Example:

"premium_monthly"

​
url
string
required

Canonical API path.

Example:

"/v4/products/premium_monthly"

​
created_at
string<date-time>
required

Creation timestamp (ISO 8601 UTC).

Example:

"2025-09-15T12:30:00Z"

​
updated_at
string<date-time>
required

Last update timestamp (ISO 8601 UTC).

Example:

"2025-11-03T10:26:40Z"

​
type
string | null

Product type (open enum). Values mirror the Qonversion dashboard labels: subscription_with_promo (Subscription With Promo Period), subscription (Regular Subscription), consumable, lifetime.

​
duration
string | null

Subscription duration in ISO 8601 period format (open enum). Only products of type subscription_with_promo or subscription may have a duration; consumable and lifetime are always null.

​
apple_product_id
string | null

Apple App Store product identifier.

​
google_product_id
string | null

Google Play product identifier.

​
google_base_plan_id
string | null

Google Play base plan identifier.

​
stripe_product_id
string | null

Stripe product identifier.