curl -X POST \
'https://api.appcharge.com/v2/offer/special-offer-1' \
-H 'Content-Type: application/json' \
-d '{
"name": "My New Special Offer Name",
"type": "SpecialOffer",
"active": true,
"segments": [
"New User"
],
"productsSequence": [
{
"index": 1,
"playerAvailability": 12,
"products": [
{
"priority": "Sub",
"publisherProductId": "6cb43621ccf1",
"quantity": "100",
}
]
"priceInUsdCents": 1000
}
],
"productSale": {
"type": "percentage",
"sale": 100
},
"priceDiscount": {
"type": "percentage",
"discount": 20
},
"displayName": "My Special Offer",
"description": "This is my special offer description.",
"offerUiId": "2bc77ff889b",
"offerExternalUiId": "2bc22377ff889cc",
"badges": [
{
"publisherBadgeId": "12ac77ff889b"
}
]
}'
{
"publisherId": "35nb7861ec9924a6b69a0fe59",
"offerId": "226cff96123a8717",
"publisherOfferId": "special-offer-1",
"displayName": "My Special Offer",
"description": "This is my special offer description.",
"name": "My New Special Offer Name",
"type": "SpecialOffer",
"active": true,
"segments": [
"New User"
],
"offerUi": {
"offerUiId": "2bc77ff889b",
"active": true,
"offerUiType": "SpecialOffer",
"name": "specialOffer1",
"description": "description",
"backgroundImage": "https://media.appcharge.com/media/65cb7182__4dc30c81-e4aa-40e8-9033-84cb05721bd0",
"borderColor": {
"colorOne": "#ffffff",
"colorTwo": "",
"direction": ""
},
"borderWidth": 2,
"externalId": "specialOffer1"
},
"productsSequence": [
{
"index": 1,
"playerAvailability": 12,
"products": [
{
"product": {
"publisherProductId": "6cb43621ccf1",
"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": "75cc91114cf653a9cc2dce2c"
},
"publisherProductId": "6cb43621ccf1",
"quantity": 1000,
"priority": "Main"
}
],
"priceInUsdCents": 980,
"badges": [],
"id": "68b4092c7a895e559a3ac8d9"
}
],
"productSale": {
"type": "percentage",
"sale": 100
},
"priceDiscount": {
"type": "percentage",
"discount": 20
},
"offerExternalUiId": "2bc22377ff889cc",
"badges": [
{
"publisherBadgeId": "12ac77ff889b"
}
],
"createdAt": "2025-04-06T10:00:44.528Z",
"updatedAt": "2025-06-06T10:00:44.528Z"
}
Updates a special offer.
curl -X POST \
'https://api.appcharge.com/v2/offer/special-offer-1' \
-H 'Content-Type: application/json' \
-d '{
"name": "My New Special Offer Name",
"type": "SpecialOffer",
"active": true,
"segments": [
"New User"
],
"productsSequence": [
{
"index": 1,
"playerAvailability": 12,
"products": [
{
"priority": "Sub",
"publisherProductId": "6cb43621ccf1",
"quantity": "100",
}
]
"priceInUsdCents": 1000
}
],
"productSale": {
"type": "percentage",
"sale": 100
},
"priceDiscount": {
"type": "percentage",
"discount": 20
},
"displayName": "My Special Offer",
"description": "This is my special offer description.",
"offerUiId": "2bc77ff889b",
"offerExternalUiId": "2bc22377ff889cc",
"badges": [
{
"publisherBadgeId": "12ac77ff889b"
}
]
}'
{
"publisherId": "35nb7861ec9924a6b69a0fe59",
"offerId": "226cff96123a8717",
"publisherOfferId": "special-offer-1",
"displayName": "My Special Offer",
"description": "This is my special offer description.",
"name": "My New Special Offer Name",
"type": "SpecialOffer",
"active": true,
"segments": [
"New User"
],
"offerUi": {
"offerUiId": "2bc77ff889b",
"active": true,
"offerUiType": "SpecialOffer",
"name": "specialOffer1",
"description": "description",
"backgroundImage": "https://media.appcharge.com/media/65cb7182__4dc30c81-e4aa-40e8-9033-84cb05721bd0",
"borderColor": {
"colorOne": "#ffffff",
"colorTwo": "",
"direction": ""
},
"borderWidth": 2,
"externalId": "specialOffer1"
},
"productsSequence": [
{
"index": 1,
"playerAvailability": 12,
"products": [
{
"product": {
"publisherProductId": "6cb43621ccf1",
"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": "75cc91114cf653a9cc2dce2c"
},
"publisherProductId": "6cb43621ccf1",
"quantity": 1000,
"priority": "Main"
}
],
"priceInUsdCents": 980,
"badges": [],
"id": "68b4092c7a895e559a3ac8d9"
}
],
"productSale": {
"type": "percentage",
"sale": 100
},
"priceDiscount": {
"type": "percentage",
"discount": 20
},
"offerExternalUiId": "2bc22377ff889cc",
"badges": [
{
"publisherBadgeId": "12ac77ff889b"
}
],
"createdAt": "2025-04-06T10:00:44.528Z",
"updatedAt": "2025-06-06T10:00:44.528Z"
}
curl -X POST \
'https://api.appcharge.com/v2/offer/special-offer-1' \
-H 'Content-Type: application/json' \
-d '{
"name": "My New Special Offer Name",
"type": "SpecialOffer",
"active": true,
"segments": [
"New User"
],
"productsSequence": [
{
"index": 1,
"playerAvailability": 12,
"products": [
{
"priority": "Sub",
"publisherProductId": "6cb43621ccf1",
"quantity": "100",
}
]
"priceInUsdCents": 1000
}
],
"productSale": {
"type": "percentage",
"sale": 100
},
"priceDiscount": {
"type": "percentage",
"discount": 20
},
"displayName": "My Special Offer",
"description": "This is my special offer description.",
"offerUiId": "2bc77ff889b",
"offerExternalUiId": "2bc22377ff889cc",
"badges": [
{
"publisherBadgeId": "12ac77ff889b"
}
]
}'
{
"publisherId": "35nb7861ec9924a6b69a0fe59",
"offerId": "226cff96123a8717",
"publisherOfferId": "special-offer-1",
"displayName": "My Special Offer",
"description": "This is my special offer description.",
"name": "My New Special Offer Name",
"type": "SpecialOffer",
"active": true,
"segments": [
"New User"
],
"offerUi": {
"offerUiId": "2bc77ff889b",
"active": true,
"offerUiType": "SpecialOffer",
"name": "specialOffer1",
"description": "description",
"backgroundImage": "https://media.appcharge.com/media/65cb7182__4dc30c81-e4aa-40e8-9033-84cb05721bd0",
"borderColor": {
"colorOne": "#ffffff",
"colorTwo": "",
"direction": ""
},
"borderWidth": 2,
"externalId": "specialOffer1"
},
"productsSequence": [
{
"index": 1,
"playerAvailability": 12,
"products": [
{
"product": {
"publisherProductId": "6cb43621ccf1",
"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": "75cc91114cf653a9cc2dce2c"
},
"publisherProductId": "6cb43621ccf1",
"quantity": 1000,
"priority": "Main"
}
],
"priceInUsdCents": 980,
"badges": [],
"id": "68b4092c7a895e559a3ac8d9"
}
],
"productSale": {
"type": "percentage",
"sale": 100
},
"priceDiscount": {
"type": "percentage",
"discount": 20
},
"offerExternalUiId": "2bc22377ff889cc",
"badges": [
{
"publisherBadgeId": "12ac77ff889b"
}
],
"createdAt": "2025-04-06T10:00:44.528Z",
"updatedAt": "2025-06-06T10:00:44.528Z"
}
The publisher token used for authentication.
The special offer ID provided by the publisher. This is the offer's External ID value in the Publisher Dashboard.
Special offer updated successfully.
The response is of type object
.
Was this page helpful?