Skip to main content
POST
/
components
/
v1
/
product
cURL
curl --request POST \
  --url https://api-sandbox.appcharge.com/components/v1/product \
  --header 'Content-Type: application/json' \
  --header 'x-publisher-token: <api-key>' \
  --data '
{
  "name": "Gold Coins Pack",
  "publisherProductId": "gold_coins_100",
  "type": "Quantity",
  "textFontColorHex": "#f5c518",
  "productImageUrl": "https://media.appcharge.com/media/69133d595af23405d8e843a5",
  "displayName": "Gold Coins",
  "description": "A pack of 100 gold coins.",
  "prefix": "Get",
  "suffix": "coins",
  "productPrefixImageUrl": "https://media.appcharge.com/media/69133d595af23405d8e843a5"
}
'
{
  "id": "507f1f77bcf86cd799439015",
  "name": "Gold Coins Pack",
  "displayName": "Gold Coins",
  "publisherProductId": "gold_coins_100",
  "type": "Quantity",
  "description": "A pack of 100 gold coins.",
  "prefix": "Get",
  "suffix": "coins",
  "textFontColorHex": "#f5c518",
  "productImageUrl": "https://media.appcharge.com/media/69133d595af23405d8e843a5",
  "productPrefixImageUrl": "https://media.appcharge.com/media/69133d595af23405d8e843a5",
  "productImageExternalUrl": "https://images.pexels.com/photos/35406321/pexels-photo-35406321.jpeg"
}

Documentation Index

Fetch the complete documentation index at: https://docs.appcharge.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-publisher-token
string
header
required

Publisher token, as displayed in the Publisher Dashboard.

Body

application/json
​
name
string
required

Product name.

Example:

"Gold Coins Pack"

​
publisherProductId
string
required

Product ID that you define.

Example:

"gold_coins_100"

​
type
enum<string>
required

Product unit type.

Available options:
Quantity,
Time
Example:

"Quantity"

​
textFontColorHex
string
required

Product text font color in hex format.

Pattern: ^#[0-9a-fA-F]{6}$
Example:

"#f5c518"

​
productImageUrl
string<url>
required

Product image URL in PNG or JPEG format.

For uploaded files, this is the Appcharge-hosted CDN URL. For external image URLs, this is the original image URL served from the provided URL. External image URLs are saved and used as-is, and Appcharge doesn't download, copy, upload, or host them. Images must remain available at the provided URLs.

We recommend uploading image files instead of using external URLs when possible.

Example:

"https://media.appcharge.com/media/69133d595af23405d8e843a5"

​
displayName
string

Product display name.

Example:

"Gold Coins"

​
description
string

Product description.

Example:

"A pack of 100 gold coins."

​
prefix
string

Product prefix text.

Example:

"Get"

​
suffix
string

Product suffix text.

Example:

"coins"

​
productPrefixImageUrl
string<url>

Product prefix image URL in PNG or JPEG format.

For uploaded files, this is the Appcharge-hosted CDN URL. For external image URLs, this is the original image URL served from the provided URL. External image URLs are saved and used as-is, and Appcharge doesn't download, copy, upload, or host them. Images must remain available at the provided URLs.

We recommend uploading image files instead of using external URLs when possible.

Example:

"https://media.appcharge.com/media/69133d595af23405d8e843a5"

Response

Product created successfully.

​
id
string

Product ID.

Example:

"507f1f77bcf86cd799439015"

​
name
string

Product name.

Example:

"Gold Coins Pack"

​
displayName
string

Product display name.

Example:

"Gold Coins"

​
publisherProductId
string

Product ID that you defined.

Example:

"gold_coins_100"

​
type
enum<string>

Product unit type.

Available options:
Quantity,
Time
Example:

"Quantity"

​
description
string

Product description.

Example:

"A pack of 100 gold coins."

​
prefix
string

Product prefix text.

Example:

"Get"

​
suffix
string

Product suffix text.

Example:

"coins"

​
textFontColorHex
string

Product text font color in hex format.

Pattern: ^#[0-9a-fA-F]{6}$
Example:

"#f5c518"

​
productImageUrl
string<url>

Product image URL. For uploaded files, this is the Appcharge-hosted CDN URL. For external image URLs, this is the original image URL served from the provided URL.

Example:

"https://media.appcharge.com/media/69133d595af23405d8e843a5"

​
productPrefixImageUrl
string<url>

Product prefix image URL. For uploaded files, this is the Appcharge-hosted CDN URL. For external image URLs, this is the original image URL served from the provided URL.

Example:

"https://media.appcharge.com/media/69133d595af23405d8e843a5"

​
productImageExternalUrl
string<url>

Original product image URL when the product uses an external image URL. This URL is used as provided to serve the image.

Example:

"https://images.pexels.com/photos/35406321/pexels-photo-35406321.jpeg"