Overview
What's New
Web Store
- Player Authentication
- Offers
- Offers V1 API
- Introduction
- POSTCreate Offer
- PUTUpdate Offer
- DELDelete Offer
- POSTGet Offer
- Rolling Offer V1 API
- Popups V1 API
- Offers V2 API
- Personalization
- Webhooks
Checkout
- Checkout Session
- Orders
- Finance and Analytics
- Checkout Webhooks
Events Center
- Introduction
- Login Events
- Store Interaction Events
- Error Events
- Order Events
- Refund and Dispute Events
Offers V1 API
Create Offer
POST
/
offering
/
offer
Copy
curl --request POST \
--url https://api-sandbox.appcharge.com/offering/offer \
--header 'Content-Type: application/json' \
--header 'x-publisher-token: <x-publisher-token>' \
--data '{
"publisherOfferId": "offer1",
"name": "Test_Bundle",
"type": "Bundle",
"active": true,
"segments": [
"NewUser"
],
"productsSequence": [
{
"index": 1,
"priceInUsdCents": 300,
"products": []
}
],
"priceDiscount": {
"priceBeforeDiscount": 1000,
"discount": 10,
"type": "percentage"
}
}'
Copy
{
"offerId": "<string>",
"publisherOfferId": "<string>",
"name": "<string>",
"displayName": "<string>",
"description": "<string>",
"type": "<string>",
"createdBy": "<string>",
"offerUi": {
"offerUiId": "<string>",
"externalId": "<string>",
"active": true,
"offerUiType": "<string>",
"name": "<string>",
"description": "<string>",
"backgroundImage": "<string>",
"specialOffer": {
"templateType": "<string>",
"presentOfferEndTimer": true,
"title": "<string>",
"fontSize": 123,
"fontWeight": "<string>",
"fontColor": {
"colorOne": "<string>",
"colorTwo": "<string>",
"direction": "<string>"
},
"backgroundColor": {
"colorOne": "<string>",
"colorTwo": "<string>",
"direction": "<string>"
}
}
},
"dynamicOfferUi": {
"badges": [
{
"publisherBadgeId": "<string>",
"position": "<string>"
}
],
"salePercentage": 123,
"salePercentageDisplayType": "percentage"
},
"active": true,
"segments": [
"<string>"
],
"productsSequence": [
{
"index": 123,
"playerAvailability": 123,
"priceInUsdCents": 123,
"products": [
{
"quantity": 123,
"product": {
"publisherProductId": "<string>",
"name": "<string>",
"textFontColorHex": "<string>",
"type": "<string>",
"prefix": "<string>",
"suffix": "<string>",
"priority": "<string>",
"images": [
{
"type": "<string>",
"url": "<string>"
}
],
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"productId": "<string>"
}
}
]
}
],
"startOver": true,
"priority": 123,
"showAfter": "<string>",
"triggers": [
{
"type": "<string>",
"eventName": "<string>",
"every": 123,
"rules": [
"<any>"
]
}
],
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
Headers
The publisher token
Body
application/json
Response
201
application/json
Create a new Offer
The response is of type object
.
Was this page helpful?
Copy
curl --request POST \
--url https://api-sandbox.appcharge.com/offering/offer \
--header 'Content-Type: application/json' \
--header 'x-publisher-token: <x-publisher-token>' \
--data '{
"publisherOfferId": "offer1",
"name": "Test_Bundle",
"type": "Bundle",
"active": true,
"segments": [
"NewUser"
],
"productsSequence": [
{
"index": 1,
"priceInUsdCents": 300,
"products": []
}
],
"priceDiscount": {
"priceBeforeDiscount": 1000,
"discount": 10,
"type": "percentage"
}
}'
Copy
{
"offerId": "<string>",
"publisherOfferId": "<string>",
"name": "<string>",
"displayName": "<string>",
"description": "<string>",
"type": "<string>",
"createdBy": "<string>",
"offerUi": {
"offerUiId": "<string>",
"externalId": "<string>",
"active": true,
"offerUiType": "<string>",
"name": "<string>",
"description": "<string>",
"backgroundImage": "<string>",
"specialOffer": {
"templateType": "<string>",
"presentOfferEndTimer": true,
"title": "<string>",
"fontSize": 123,
"fontWeight": "<string>",
"fontColor": {
"colorOne": "<string>",
"colorTwo": "<string>",
"direction": "<string>"
},
"backgroundColor": {
"colorOne": "<string>",
"colorTwo": "<string>",
"direction": "<string>"
}
}
},
"dynamicOfferUi": {
"badges": [
{
"publisherBadgeId": "<string>",
"position": "<string>"
}
],
"salePercentage": 123,
"salePercentageDisplayType": "percentage"
},
"active": true,
"segments": [
"<string>"
],
"productsSequence": [
{
"index": 123,
"playerAvailability": 123,
"priceInUsdCents": 123,
"products": [
{
"quantity": 123,
"product": {
"publisherProductId": "<string>",
"name": "<string>",
"textFontColorHex": "<string>",
"type": "<string>",
"prefix": "<string>",
"suffix": "<string>",
"priority": "<string>",
"images": [
{
"type": "<string>",
"url": "<string>"
}
],
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z",
"productId": "<string>"
}
}
]
}
],
"startOver": true,
"priority": 123,
"showAfter": "<string>",
"triggers": [
{
"type": "<string>",
"eventName": "<string>",
"every": 123,
"rules": [
"<any>"
]
}
],
"createdAt": "2023-11-07T05:31:56Z",
"updatedAt": "2023-11-07T05:31:56Z"
}
Assistant
Responses are generated using AI and may contain mistakes.