Create a product

posthttps://api.paddle.com/products

Creates a new product.

Paddle does not upload product images to a CDN. For image_url, you should host images on an HTTPS server that's publicly accessible. We recommend using square images (1:1 ratio).

If successful, your response includes a copy of the new product entity.

Request Body

namestringrequired

Name of this product.

tax_categorystringrequired

Tax category for this product. Used for charging the correct rate of tax. Selected tax category must be enabled on your Paddle account.

descriptionstring or null

Short description for this product.

typestring

Type of item. Standard items are considered part of your catalog and are shown on the Paddle web app. If omitted, defaults to standard.

image_urlstring<uri> or null

Image for this product. Included in the checkout and on some customer documents.

custom_dataobject or null

Your own structured key-value data.

Response

dataobject

Represents a product entity.

idstring

Unique Paddle ID for this product, prefixed with pro_.

namestring

Name of this product.

descriptionstring or null

Short description for this product.

typestring

Type of item. Standard items are considered part of your catalog and are shown on the Paddle web app.

tax_categorystring

Tax category for this product. Used for charging the correct rate of tax. Selected tax category must be enabled on your Paddle account.

image_urlstring<uri> or null

Image for this product. Included in the checkout and on some customer documents.

custom_dataobject or null

Your own structured key-value data.

statusstring

Whether this entity can be used in Paddle.

import_metaobject or null

Import information for this entity. null if this entity is not imported.

created_atstring<date-time>

RFC 3339 datetime string of when this entity was created. Set automatically by Paddle.

updated_atstring<date-time>

RFC 3339 datetime string of when this entity was updated. Set automatically by Paddle.

metaobject

Information about this response.

request_idstring

Unique ID for the request relating to this response. Provide this when contacting Paddle support about a specific request.

Request

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
1{
2  "name": "AeroEdit Student",
3  "tax_category": "standard",
4  "description": "Essential tools for student pilots to manage flight logs, analyze performance, and plan routes, and ensure compliance. Valid student pilot certificate from the FAA required.",
5  "image_url": "https://paddle.s3.amazonaws.com/user/165798/bT1XUOJAQhOUxGs83cbk_pro.png",
6  "custom_data": {
7    "features": {
8      "aircraft_performance": true,
9      "compliance_monitoring": false,
10      "flight_log_management": true,
11      "payment_by_invoice": false,
12      "route_planning": true,
13      "sso": false
14    },
15    "suggested_addons": [
16      "pro_01h1vjes1y163xfj1rh1tkfb65",
17      "pro_01gsz97mq9pa4fkyy0wqenepkz"
18    ],
19    "upgrade_description": null
20  }

Response