> ## Documentation Index > Fetch the complete documentation index at: https://dodopayments-mintlify-external-integration-datafast-autosen.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Create Product > Create a new product. ## OpenAPI ````yaml post /products openapi: 3.1.0 info: title: public description: '' license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0 version: 1.61.5 servers: - url: https://test.dodopayments.com/ description: Test Mode Server Host - url: https://live.dodopayments.com/ description: Live Mode Server Host security: [] tags: - name: Products - name: Payments - name: Subscriptions - name: Addons - name: Customers - name: Refunds - name: Disputes - name: Events - name: License Keys - name: Licenses - name: Discounts - name: Meters - name: Outgoing Webhooks - name: Checkout - name: Webhook Events paths: /products: post: tags: - Products operationId: create_product requestBody: content: application/json: schema: $ref: '#/components/schemas/CreateProductRequest' required: true responses: '200': description: Product Created Successfully content: application/json: schema: $ref: '#/components/schemas/GetProductResponse' '422': description: Invalid Request Object or Parameters '500': description: Something went wrong :( security: - API_KEY: [] x-codeSamples: - lang: JavaScript source: |- import DodoPayments from 'dodopayments'; const client = new DodoPayments({ bearerToken: 'My Bearer Token', }); const product = await client.products.create({ name: 'name', price: { currency: 'AED', discount: 0, price: 0, purchasing_power_parity: true, type: 'one_time_price' }, tax_category: 'digital_products', }); console.log(product.brand_id); - lang: Python source: |- from dodopayments import DodoPayments client = DodoPayments( bearer_token="My Bearer Token", ) product = client.products.create( name="name", price={ "currency": "AED", "discount": 0, "price": 0, "purchasing_power_parity": True, "type": "one_time_price", }, tax_category="digital_products", ) print(product.brand_id) - lang: Go source: | package main import ( "context" "fmt" "github.com/dodopayments/dodopayments-go" "github.com/dodopayments/dodopayments-go/option" ) func main() { client := dodopayments.NewClient( option.WithBearerToken("My Bearer Token"), ) product, err := client.Products.New(context.TODO(), dodopayments.ProductNewParams{ Name: dodopayments.F("name"), Price: dodopayments.F[dodopayments.PriceUnionParam](dodopayments.PriceOneTimePriceParam{ Currency: dodopayments.F(dodopayments.CurrencyAed), Discount: dodopayments.F(int64(0)), Price: dodopayments.F(int64(0)), PurchasingPowerParity: dodopayments.F(true), Type: dodopayments.F(dodopayments.PriceOneTimePriceTypeOneTimePrice), }), TaxCategory: dodopayments.F(dodopayments.TaxCategoryDigitalProducts), }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", product.BrandID) } - lang: Java source: |- package com.dodopayments.api.example; import com.dodopayments.api.client.DodoPaymentsClient; import com.dodopayments.api.client.okhttp.DodoPaymentsOkHttpClient; import com.dodopayments.api.models.misc.Currency; import com.dodopayments.api.models.misc.TaxCategory; import com.dodopayments.api.models.products.Price; import com.dodopayments.api.models.products.Product; import com.dodopayments.api.models.products.ProductCreateParams; public final class Main { private Main() {} public static void main(String[] args) { DodoPaymentsClient client = DodoPaymentsOkHttpClient.fromEnv(); ProductCreateParams params = ProductCreateParams.builder() .name("name") .price(Price.OneTimePrice.builder() .currency(Currency.AED) .discount(0L) .price(0) .purchasingPowerParity(true) .type(Price.OneTimePrice.Type.ONE_TIME_PRICE) .build()) .taxCategory(TaxCategory.DIGITAL_PRODUCTS) .build(); Product product = client.products().create(params); } } - lang: Kotlin source: |- package com.dodopayments.api.example import com.dodopayments.api.client.DodoPaymentsClient import com.dodopayments.api.client.okhttp.DodoPaymentsOkHttpClient import com.dodopayments.api.models.misc.Currency import com.dodopayments.api.models.misc.TaxCategory import com.dodopayments.api.models.products.Price import com.dodopayments.api.models.products.Product import com.dodopayments.api.models.products.ProductCreateParams fun main() { val client: DodoPaymentsClient = DodoPaymentsOkHttpClient.fromEnv() val params: ProductCreateParams = ProductCreateParams.builder() .name("name") .price(Price.OneTimePrice.builder() .currency(Currency.AED) .discount(0L) .price(0) .purchasingPowerParity(true) .type(Price.OneTimePrice.Type.ONE_TIME_PRICE) .build()) .taxCategory(TaxCategory.DIGITAL_PRODUCTS) .build() val product: Product = client.products().create(params) } - lang: Ruby source: |- require "dodopayments" dodo_payments = Dodopayments::Client.new( bearer_token: "My Bearer Token", environment: "test_mode" # defaults to "live_mode" ) product = dodo_payments.products.create( name: "name", price: {currency: :AED, discount: 0, price: 0, purchasing_power_parity: true, type: :one_time_price}, tax_category: :digital_products ) puts(product) components: schemas: CreateProductRequest: type: object required: - name - tax_category - price properties: addons: type: - array - 'null' items: type: string description: Addons available for subscription product brand_id: type: - string - 'null' description: >- Brand id for the product, if not provided will default to primary brand description: type: - string - 'null' description: Optional description of the product digital_product_delivery: oneOf: - type: 'null' - $ref: '#/components/schemas/CreateDigitalProductDeliveryRequest' description: Choose how you would like you digital product delivered license_key_activation_message: type: - string - 'null' description: Optional message displayed during license key activation license_key_activations_limit: type: - integer - 'null' format: int32 description: |- The number of times the license key can be activated. Must be 0 or greater license_key_duration: oneOf: - type: 'null' - $ref: '#/components/schemas/LicenseKeyDuration' description: >- Duration configuration for the license key. Set to null if you don't want the license key to expire. For subscriptions, the lifetime of the license key is tied to the subscription period license_key_enabled: type: - boolean - 'null' description: |- When true, generates and sends a license key to your customer. Defaults to false metadata: $ref: '#/components/schemas/Metadata' description: Additional metadata for the product name: type: string description: Name of the product price: $ref: '#/components/schemas/Price' description: Price configuration for the product tax_category: $ref: '#/components/schemas/TaxCategory' description: Tax category applied to this product GetProductResponse: type: object required: - product_id - business_id - created_at - updated_at - is_recurring - tax_category - price - license_key_enabled - brand_id - metadata properties: addons: type: - array - 'null' items: type: string description: Available Addons for subscription products brand_id: type: string business_id: type: string description: Unique identifier for the business to which the product belongs. created_at: type: string format: date-time description: Timestamp when the product was created. description: type: - string - 'null' description: Description of the product, optional. digital_product_delivery: oneOf: - type: 'null' - $ref: '#/components/schemas/DigitalProductDelivery' image: type: - string - 'null' description: URL of the product image, optional. is_recurring: type: boolean description: Indicates if the product is recurring (e.g., subscriptions). license_key_activation_message: type: - string - 'null' description: Message sent upon license key activation, if applicable. license_key_activations_limit: type: - integer - 'null' format: int32 description: Limit on the number of activations for the license key, if enabled. license_key_duration: oneOf: - type: 'null' - $ref: '#/components/schemas/LicenseKeyDuration' description: Duration of the license key validity, if enabled. license_key_enabled: type: boolean description: Indicates whether the product requires a license key. metadata: $ref: '#/components/schemas/Metadata' description: Additional custom data associated with the product name: type: - string - 'null' description: Name of the product, optional. price: $ref: '#/components/schemas/Price' description: Pricing information for the product. product_id: type: string description: Unique identifier for the product. tax_category: $ref: '#/components/schemas/TaxCategory' description: Tax category associated with the product. updated_at: type: string format: date-time description: Timestamp when the product was last updated. CreateDigitalProductDeliveryRequest: type: object title: Create Digital Product Delivery Request properties: external_url: type: - string - 'null' description: External URL to digital product instructions: type: - string - 'null' description: Instructions to download and use the digital product LicenseKeyDuration: type: object title: License Key Duration required: - count - interval properties: count: type: integer format: int32 interval: $ref: '#/components/schemas/TimeInterval' Metadata: type: object additionalProperties: type: string propertyNames: type: string Price: oneOf: - allOf: - $ref: '#/components/schemas/OneTimePrice' description: One-time price details. - type: object required: - type properties: type: type: string enum: - one_time_price title: One Time Price description: One-time price details. - allOf: - $ref: '#/components/schemas/RecurringPrice' description: Recurring price details. - type: object required: - type properties: type: type: string enum: - recurring_price title: Recurring Price description: Recurring price details. - allOf: - $ref: '#/components/schemas/UsageBasedPrice' description: Usage Based price details. - type: object required: - type properties: type: type: string enum: - usage_based_price title: Usage Based Price description: Usage Based price details. TaxCategory: type: string description: >- Represents the different categories of taxation applicable to various products and services. enum: - digital_products - saas - e_book - edtech DigitalProductDelivery: type: object title: Digital Product Delivery properties: external_url: type: - string - 'null' description: External URL to digital product files: type: - array - 'null' items: $ref: '#/components/schemas/DigitalProductDeliveryFile' description: Uploaded files ids of digital product instructions: type: - string - 'null' description: Instructions to download and use the digital product TimeInterval: type: string enum: - Day - Week - Month - Year OneTimePrice: type: object title: One Time Price required: - price - currency - discount - purchasing_power_parity properties: currency: $ref: '#/components/schemas/Currency' description: The currency in which the payment is made. discount: type: integer format: int64 description: >- Discount applied to the price, represented as a percentage (0 to 100). pay_what_you_want: type: boolean description: >- Indicates whether the customer can pay any amount they choose. If set to `true`, the [`price`](Self::price) field is the minimum amount. price: type: integer format: int32 description: >- The payment amount, in the smallest denomination of the currency (e.g., cents for USD). For example, to charge $1.00, pass `100`. If [`pay_what_you_want`](Self::pay_what_you_want) is set to `true`, this field represents the **minimum** amount the customer must pay. purchasing_power_parity: type: boolean description: >- Indicates if purchasing power parity adjustments are applied to the price. Purchasing power parity feature is not available as of now. suggested_price: type: - integer - 'null' format: int32 description: >- A suggested price for the user to pay. This value is only considered if [`pay_what_you_want`](Self::pay_what_you_want) is `true`. Otherwise, it is ignored. tax_inclusive: type: - boolean - 'null' description: Indicates if the price is tax inclusive. RecurringPrice: type: object title: Recurring Price required: - price - currency - discount - purchasing_power_parity - payment_frequency_count - payment_frequency_interval - subscription_period_count - subscription_period_interval properties: currency: $ref: '#/components/schemas/Currency' description: The currency in which the payment is made. discount: type: integer format: int64 description: >- Discount applied to the price, represented as a percentage (0 to 100). payment_frequency_count: type: integer format: int32 description: >- Number of units for the payment frequency. For example, a value of `1` with a `payment_frequency_interval` of `month` represents monthly payments. payment_frequency_interval: $ref: '#/components/schemas/TimeInterval' description: >- The time interval for the payment frequency (e.g., day, month, year). price: type: integer format: int32 description: >- The payment amount. Represented in the lowest denomination of the currency (e.g., cents for USD). For example, to charge $1.00, pass `100`. purchasing_power_parity: type: boolean description: >- Indicates if purchasing power parity adjustments are applied to the price. Purchasing power parity feature is not available as of now subscription_period_count: type: integer format: int32 description: >- Number of units for the subscription period. For example, a value of `12` with a `subscription_period_interval` of `month` represents a one-year subscription. subscription_period_interval: $ref: '#/components/schemas/TimeInterval' description: >- The time interval for the subscription period (e.g., day, month, year). tax_inclusive: type: - boolean - 'null' description: Indicates if the price is tax inclusive trial_period_days: type: integer format: int32 description: >- Number of days for the trial period. A value of `0` indicates no trial period. UsageBasedPrice: type: object title: Usage Based Price required: - fixed_price - currency - discount - purchasing_power_parity - payment_frequency_count - payment_frequency_interval - subscription_period_count - subscription_period_interval properties: currency: $ref: '#/components/schemas/Currency' description: The currency in which the payment is made. discount: type: integer format: int64 description: >- Discount applied to the price, represented as a percentage (0 to 100). fixed_price: type: integer format: int32 description: >- The fixed payment amount. Represented in the lowest denomination of the currency (e.g., cents for USD). For example, to charge $1.00, pass `100`. meters: type: - array - 'null' items: $ref: '#/components/schemas/AddMeterToPrice' payment_frequency_count: type: integer format: int32 description: >- Number of units for the payment frequency. For example, a value of `1` with a `payment_frequency_interval` of `month` represents monthly payments. payment_frequency_interval: $ref: '#/components/schemas/TimeInterval' description: >- The time interval for the payment frequency (e.g., day, month, year). purchasing_power_parity: type: boolean description: >- Indicates if purchasing power parity adjustments are applied to the price. Purchasing power parity feature is not available as of now subscription_period_count: type: integer format: int32 description: >- Number of units for the subscription period. For example, a value of `12` with a `subscription_period_interval` of `month` represents a one-year subscription. subscription_period_interval: $ref: '#/components/schemas/TimeInterval' description: >- The time interval for the subscription period (e.g., day, month, year). tax_inclusive: type: - boolean - 'null' description: Indicates if the price is tax inclusive DigitalProductDeliveryFile: type: object title: Digital Product Delivery File required: - file_id - file_name - url properties: file_id: type: string format: uuid file_name: type: string url: type: string Currency: type: string enum: - AED - ALL - AMD - ANG - AOA - ARS - AUD - AWG - AZN - BAM - BBD - BDT - BGN - BHD - BIF - BMD - BND - BOB - BRL - BSD - BWP - BYN - BZD - CAD - CHF - CLP - CNY - COP - CRC - CUP - CVE - CZK - DJF - DKK - DOP - DZD - EGP - ETB - EUR - FJD - FKP - GBP - GEL - GHS - GIP - GMD - GNF - GTQ - GYD - HKD - HNL - HRK - HTG - HUF - IDR - ILS - INR - IQD - JMD - JOD - JPY - KES - KGS - KHR - KMF - KRW - KWD - KYD - KZT - LAK - LBP - LKR - LRD - LSL - LYD - MAD - MDL - MGA - MKD - MMK - MNT - MOP - MRU - MUR - MVR - MWK - MXN - MYR - MZN - NAD - NGN - NIO - NOK - NPR - NZD - OMR - PAB - PEN - PGK - PHP - PKR - PLN - PYG - QAR - RON - RSD - RUB - RWF - SAR - SBD - SCR - SEK - SGD - SHP - SLE - SLL - SOS - SRD - SSP - STN - SVC - SZL - THB - TND - TOP - TRY - TTD - TWD - TZS - UAH - UGX - USD - UYU - UZS - VES - VND - VUV - WST - XAF - XCD - XOF - XPF - YER - ZAR - ZMW AddMeterToPrice: type: object title: Add Meter To Price required: - meter_id - price_per_unit properties: description: type: - string - 'null' description: >- Meter description. Will ignored on Request, but will be shown in response free_threshold: type: - integer - 'null' format: int64 measurement_unit: type: - string - 'null' description: >- Meter measurement unit. Will ignored on Request, but will be shown in response meter_id: type: string name: type: - string - 'null' description: Meter name. Will ignored on Request, but will be shown in response price_per_unit: type: string description: >- The price per unit in lowest denomination. Must be greater than zero. Supports up to 5 digits before decimal point and 12 decimal places. example: '10.50' securitySchemes: API_KEY: type: http scheme: bearer ````