curl -X POST \
'https://api.appcharge.com/v2/offer' \
-H 'Content-Type: application/json' \
-H 'x-publisher-token: <x-publisher-token>' \
-d '{
"publisherOfferId": "bundle-offer-1",
"name": "My Bundle",
"type": "Bundle",
"active": true,
"segments": [
"New User"
],
"publisherTabId": "tab-1",
"productsSequence": [
{
"index": 1,
"products": [
{
"priority": "Sub",
"publisherProductId": "123",
"quantity": "500",
}
]
"priceInUsdCents": 980,
"progressBarPoints": [
{
"barId": "69525aae0cbfad2a5507cd54",
"points": 10
}
],
}
],
"productSale": {
"type": "percentage",
"sale": 100
},
"priceDiscount": {
"type": "percentage",
"discount": 20
},
"displayName": "My Bundle",
"description": "This is my bundle description.",
"offerUiId": "ac77ff889b",
"offerExternalUiId": "ac22377ff889cc",
"badges": [
{
"publisherBadgeId": "22ac77ff889b"
}
]
}'
{
"publisherId": "35nb7861ec9924a6b69a0fe59",
"offerId": "226cff96123a8717",
"publisherOfferId": "bundle-offer-1",
"name": "My Bundle",
"displayName": "My Bundle",
"description": "This is my bundle description.",
"type": "Bundle",
"active": true,
"segments": [
"New User"
],
"publisherTabId": "tab-1",
"offerUi": {
"offerUiId": "27e7fb3663e1bfbbf340ffff",
"active": true,
"offerUiType": "Bundle",
"name": "BundOff273",
"description": "description",
"backgroundImage": "https://media.appcharge.com/media/65cb7182__4dc30c81-e4aa-40e8-9033-84cb05721bd0",
"borderColor": {
"colorOne": "#ffffff",
"colorTwo": "",
"direction": ""
},
"borderWidth": 2,
"externalId": "BundOff273"
},
"productsSequence": [
{
"index": 1,
"products": [
{
"product": {
"publisherProductId": "123",
"name": "Coins",
"textFontColorHex": "#FFFFFF",
"type": "Quantity",
"prefix": "",
"suffix": "",
"priority": "Sub",
"images": [
{
"type": "product",
"url": "https://media.appcharge.com/media/45cb7861ec8924a6b69a0f59/download.jpeg"
},
{
"type": "productPrefix",
"url": ""
}
],
"createdAt": "2024-02-14T10:08:17.061Z",
"updatedAt": "2024-09-27T13:41:55.775Z",
"displayName": "coins",
"productId": "65cc91114cf653a9cc2dce2c"
},
"publisherProductId": "123",
"quantity": 500,
"priority": "Main"
}
],
"priceInUsdCents": 980,
"progressBarPoints": [
{
"barId": "69525aae0cbfad2a5507cd54",
"points": 10
}
],
"badges": [],
"id": "68b4092c7a895e559a3ac8d9"
}
],
"badges": [
{
"publisherBadgeId": "22ac77ff889b"
}
],
"productSale": {
"type": "percentage",
"sale": 100
},
"priceDiscount": {
"type": "percentage",
"discount": 20
},
"createdAt": "2025-04-06T10:00:44.528Z",
"updatedAt": "2025-04-06T10:00:44.528Z"
}
Bundles
Create Bundle
Creates a bundle.
POST
/
v2
/
offer
curl -X POST \
'https://api.appcharge.com/v2/offer' \
-H 'Content-Type: application/json' \
-H 'x-publisher-token: <x-publisher-token>' \
-d '{
"publisherOfferId": "bundle-offer-1",
"name": "My Bundle",
"type": "Bundle",
"active": true,
"segments": [
"New User"
],
"publisherTabId": "tab-1",
"productsSequence": [
{
"index": 1,
"products": [
{
"priority": "Sub",
"publisherProductId": "123",
"quantity": "500",
}
]
"priceInUsdCents": 980,
"progressBarPoints": [
{
"barId": "69525aae0cbfad2a5507cd54",
"points": 10
}
],
}
],
"productSale": {
"type": "percentage",
"sale": 100
},
"priceDiscount": {
"type": "percentage",
"discount": 20
},
"displayName": "My Bundle",
"description": "This is my bundle description.",
"offerUiId": "ac77ff889b",
"offerExternalUiId": "ac22377ff889cc",
"badges": [
{
"publisherBadgeId": "22ac77ff889b"
}
]
}'
{
"publisherId": "35nb7861ec9924a6b69a0fe59",
"offerId": "226cff96123a8717",
"publisherOfferId": "bundle-offer-1",
"name": "My Bundle",
"displayName": "My Bundle",
"description": "This is my bundle description.",
"type": "Bundle",
"active": true,
"segments": [
"New User"
],
"publisherTabId": "tab-1",
"offerUi": {
"offerUiId": "27e7fb3663e1bfbbf340ffff",
"active": true,
"offerUiType": "Bundle",
"name": "BundOff273",
"description": "description",
"backgroundImage": "https://media.appcharge.com/media/65cb7182__4dc30c81-e4aa-40e8-9033-84cb05721bd0",
"borderColor": {
"colorOne": "#ffffff",
"colorTwo": "",
"direction": ""
},
"borderWidth": 2,
"externalId": "BundOff273"
},
"productsSequence": [
{
"index": 1,
"products": [
{
"product": {
"publisherProductId": "123",
"name": "Coins",
"textFontColorHex": "#FFFFFF",
"type": "Quantity",
"prefix": "",
"suffix": "",
"priority": "Sub",
"images": [
{
"type": "product",
"url": "https://media.appcharge.com/media/45cb7861ec8924a6b69a0f59/download.jpeg"
},
{
"type": "productPrefix",
"url": ""
}
],
"createdAt": "2024-02-14T10:08:17.061Z",
"updatedAt": "2024-09-27T13:41:55.775Z",
"displayName": "coins",
"productId": "65cc91114cf653a9cc2dce2c"
},
"publisherProductId": "123",
"quantity": 500,
"priority": "Main"
}
],
"priceInUsdCents": 980,
"progressBarPoints": [
{
"barId": "69525aae0cbfad2a5507cd54",
"points": 10
}
],
"badges": [],
"id": "68b4092c7a895e559a3ac8d9"
}
],
"badges": [
{
"publisherBadgeId": "22ac77ff889b"
}
],
"productSale": {
"type": "percentage",
"sale": 100
},
"priceDiscount": {
"type": "percentage",
"discount": 20
},
"createdAt": "2025-04-06T10:00:44.528Z",
"updatedAt": "2025-04-06T10:00:44.528Z"
}
curl -X POST \
'https://api.appcharge.com/v2/offer' \
-H 'Content-Type: application/json' \
-H 'x-publisher-token: <x-publisher-token>' \
-d '{
"publisherOfferId": "bundle-offer-1",
"name": "My Bundle",
"type": "Bundle",
"active": true,
"segments": [
"New User"
],
"publisherTabId": "tab-1",
"productsSequence": [
{
"index": 1,
"products": [
{
"priority": "Sub",
"publisherProductId": "123",
"quantity": "500",
}
]
"priceInUsdCents": 980,
"progressBarPoints": [
{
"barId": "69525aae0cbfad2a5507cd54",
"points": 10
}
],
}
],
"productSale": {
"type": "percentage",
"sale": 100
},
"priceDiscount": {
"type": "percentage",
"discount": 20
},
"displayName": "My Bundle",
"description": "This is my bundle description.",
"offerUiId": "ac77ff889b",
"offerExternalUiId": "ac22377ff889cc",
"badges": [
{
"publisherBadgeId": "22ac77ff889b"
}
]
}'
{
"publisherId": "35nb7861ec9924a6b69a0fe59",
"offerId": "226cff96123a8717",
"publisherOfferId": "bundle-offer-1",
"name": "My Bundle",
"displayName": "My Bundle",
"description": "This is my bundle description.",
"type": "Bundle",
"active": true,
"segments": [
"New User"
],
"publisherTabId": "tab-1",
"offerUi": {
"offerUiId": "27e7fb3663e1bfbbf340ffff",
"active": true,
"offerUiType": "Bundle",
"name": "BundOff273",
"description": "description",
"backgroundImage": "https://media.appcharge.com/media/65cb7182__4dc30c81-e4aa-40e8-9033-84cb05721bd0",
"borderColor": {
"colorOne": "#ffffff",
"colorTwo": "",
"direction": ""
},
"borderWidth": 2,
"externalId": "BundOff273"
},
"productsSequence": [
{
"index": 1,
"products": [
{
"product": {
"publisherProductId": "123",
"name": "Coins",
"textFontColorHex": "#FFFFFF",
"type": "Quantity",
"prefix": "",
"suffix": "",
"priority": "Sub",
"images": [
{
"type": "product",
"url": "https://media.appcharge.com/media/45cb7861ec8924a6b69a0f59/download.jpeg"
},
{
"type": "productPrefix",
"url": ""
}
],
"createdAt": "2024-02-14T10:08:17.061Z",
"updatedAt": "2024-09-27T13:41:55.775Z",
"displayName": "coins",
"productId": "65cc91114cf653a9cc2dce2c"
},
"publisherProductId": "123",
"quantity": 500,
"priority": "Main"
}
],
"priceInUsdCents": 980,
"progressBarPoints": [
{
"barId": "69525aae0cbfad2a5507cd54",
"points": 10
}
],
"badges": [],
"id": "68b4092c7a895e559a3ac8d9"
}
],
"badges": [
{
"publisherBadgeId": "22ac77ff889b"
}
],
"productSale": {
"type": "percentage",
"sale": 100
},
"priceDiscount": {
"type": "percentage",
"discount": 20
},
"createdAt": "2025-04-06T10:00:44.528Z",
"updatedAt": "2025-04-06T10:00:44.528Z"
}
Headers
The publisher token used for authentication.
Body
application/json
The unique identifier for the bundle.
The name of the bundle (at least 3 characters).
The type of offer - In this case 'Bundle'.
Available options:
Bundle Whether the bundle is active.
List of player segments that this bundle applies to (e.g., ["NewUser", "BigSpender"]).
The sequence of products included in the bundle.
Show child attributes
Show child attributes
If not specified, the bundle name will be used.
The description of the offer (conditionally returned).
Internal ID for the Offer UI (required if offerExternalUiId not provided).
The external UI ID for the bundle.
The publisher section ID.
Tab ID in the web store.
List of badges associated with the bundle.
Show child attributes
Show child attributes
Sale details for products in the bundle. The sale will only be applied on the first product.
Show child attributes
Show child attributes
Discount applied to the bundle price.
Show child attributes
Show child attributes
Response
Bundle created successfully.
Publisher ID.
The unique identifier of the bundle.
The bundle offer ID provided by the publisher. This is the offer's External ID value in the Publisher Dashboard.
The name of the bundle.
The display name of the bundle. If not provided, the name will be used.
The description of the offer (conditionally returned).
The type of offer.
Whether the bundle is active.
List of player segments that this bundle applies to (e.g., ["NewUser", "BigSpender"]).
Tab ID in the web store.
Details on the bundle design, as configured in the Publisher Dashboard.
Show child attributes
Show child attributes
A sequence of products in the bundle.
Show child attributes
Show child attributes
List of badges associated with the bundle
Show child attributes
Show child attributes
Sale details for products in the bundle. The sale will only be applied on the first product.
Show child attributes
Show child attributes
Discount applied to the special offer price.
Show child attributes
Show child attributes
Date the bundle was created.
Date the bundle was updated.
Was this page helpful?