v1

latestOpenAPI 3.0.32026-07-26120117318.1 KB

Products

Create a product

Creates a new product for the authenticated project.

post/products

Request body

idstring required

Unique product identifier.

typestring nullable

Product type. Mirrors dashboard labels.

durationstring nullable

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

apple_product_idstring nullable

google_product_idstring nullable

google_base_plan_idstring nullable

stripe_product_idstring nullable

Example request

{
  "id": "premium_monthly"
}

Response

Created product

object'product' required

idstring required

Unique product identifier.

urlstring required

Canonical API path.

typestring nullable

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

durationstring nullable

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_idstring nullable

Apple App Store product identifier.

google_product_idstring nullable

Google Play product identifier.

google_base_plan_idstring nullable

Google Play base plan identifier.

stripe_product_idstring nullable

Stripe product identifier.

created_atstring date-time required

Creation timestamp (ISO 8601 UTC).

updated_atstring date-time required

Last update timestamp (ISO 8601 UTC).

Example response

{
  "id": "premium_monthly",
  "url": "/v4/products/premium_monthly",
  "created_at": "2025-09-15T12:30:00Z",
  "updated_at": "2025-11-03T10:26:40Z"
}