Create Rolling Offer Design

curl -X POST \
  'https://api.appcharge.com/components/v1/offer-design' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'x-publisher-token: <x-publisher-token>' \
  --data '{
    "offerUiType": "RollingOffer",
    "name": "Rolling Offer Design",
    "externalId": "rolling-offer-design",
    "backgroundImageUrl": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/background.png",
    "backgroundColor": "#272727",
    "backgroundOpacity": 80,
    "headerImage": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/header.png",
    "arrowColor": "#ffffff",
    "borderColor": {
      "colorOne": "#ffffff",
      "colorTwo": "#ffffff",
      "gradientDirection": "to right"
    },
    "borderWidth": 2,
    "subRollingOffer": {
      "backgroundImageUrl": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/background.png",
      "collectText": "FREE"
    }
  }'

{
  "id": "694a7c8e87f78fb36a931763",
  "offerUiType": "RollingOffer",
  "name": "Rolling Offer Design",
  "externalId": "rolling-offer-design",
  "backgroundImageUrl": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/background.png",
  "backgroundColor": "#272727",
  "backgroundOpacity": 80,
  "headerImage": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/header.png",
  "arrowColor": "#ffffff",
  "borderColor": {
    "colorOne": "#ffffff",
    "colorTwo": "#ffffff",
    "direction": "to right"
  },
  "borderWidth": 2,
  "subRollingOffer": {
    "backgroundImageUrl": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/background.png",
    "collectText": "FREE"
  }
}

POST

components

offer-design

curl -X POST \
  'https://api.appcharge.com/components/v1/offer-design' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'x-publisher-token: <x-publisher-token>' \
  --data '{
    "offerUiType": "RollingOffer",
    "name": "Rolling Offer Design",
    "externalId": "rolling-offer-design",
    "backgroundImageUrl": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/background.png",
    "backgroundColor": "#272727",
    "backgroundOpacity": 80,
    "headerImage": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/header.png",
    "arrowColor": "#ffffff",
    "borderColor": {
      "colorOne": "#ffffff",
      "colorTwo": "#ffffff",
      "gradientDirection": "to right"
    },
    "borderWidth": 2,
    "subRollingOffer": {
      "backgroundImageUrl": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/background.png",
      "collectText": "FREE"
    }
  }'

{
  "id": "694a7c8e87f78fb36a931763",
  "offerUiType": "RollingOffer",
  "name": "Rolling Offer Design",
  "externalId": "rolling-offer-design",
  "backgroundImageUrl": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/background.png",
  "backgroundColor": "#272727",
  "backgroundOpacity": 80,
  "headerImage": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/header.png",
  "arrowColor": "#ffffff",
  "borderColor": {
    "colorOne": "#ffffff",
    "colorTwo": "#ffffff",
    "direction": "to right"
  },
  "borderWidth": 2,
  "subRollingOffer": {
    "backgroundImageUrl": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/background.png",
    "collectText": "FREE"
  }
}

curl -X POST \
  'https://api.appcharge.com/components/v1/offer-design' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -H 'x-publisher-token: <x-publisher-token>' \
  --data '{
    "offerUiType": "RollingOffer",
    "name": "Rolling Offer Design",
    "externalId": "rolling-offer-design",
    "backgroundImageUrl": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/background.png",
    "backgroundColor": "#272727",
    "backgroundOpacity": 80,
    "headerImage": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/header.png",
    "arrowColor": "#ffffff",
    "borderColor": {
      "colorOne": "#ffffff",
      "colorTwo": "#ffffff",
      "gradientDirection": "to right"
    },
    "borderWidth": 2,
    "subRollingOffer": {
      "backgroundImageUrl": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/background.png",
      "collectText": "FREE"
    }
  }'

{
  "id": "694a7c8e87f78fb36a931763",
  "offerUiType": "RollingOffer",
  "name": "Rolling Offer Design",
  "externalId": "rolling-offer-design",
  "backgroundImageUrl": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/background.png",
  "backgroundColor": "#272727",
  "backgroundOpacity": 80,
  "headerImage": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/header.png",
  "arrowColor": "#ffffff",
  "borderColor": {
    "colorOne": "#ffffff",
    "colorTwo": "#ffffff",
    "direction": "to right"
  },
  "borderWidth": 2,
  "subRollingOffer": {
    "backgroundImageUrl": "https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/background.png",
    "collectText": "FREE"
  }
}

Headers

x-publisher-token

string

required

Publisher token, as displayed in the Publisher Dashboard.

Body

application/json

Design a rolling offer.

offerUiType

enum<string>

required

Type of offer design.

Available options:

RollingOffer

Example:

"RollingOffer"

name

string

required

Offer design name.

Example:

"Rolling Offer Design"

externalId

string

required

Design ID that you define.

Example:

"rolling-offer-design"

backgroundImageUrl

string<url>

required

Background image URL for the offer design.

Example:

"https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/background.png"

backgroundColor

string

required

Background color of the rolling offer.

Example:

"#272727"

backgroundOpacity

number

required

Background opacity value.

Example:

80

arrowColor

string

required

Color of the arrow in the rolling offer.

Example:

"#ffffff"

borderColor

object

required

Border color configuration with gradient support.

Show child attributes

borderWidth

number

required

Width of the border in pixels.

Example:

2

subRollingOffer

object

required

Information about the sub rolling offer configuration.

Show child attributes

headerImage

string<url>

Header image URL for the rolling offer.

Example:

"https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/header.png"

Response

Offer design created successfully.

string

Design ID

Example:

"694a7c8e87f78fb36a931763"

offerUiType

enum<string>

Type of offer design.

Available options:

RollingOffer

Example:

"RollingOffer"

name

string

Offer design name.

Example:

"Rolling Offer Design"

externalId

string

Design ID that you defined.

Example:

"rolling-offer-design"

backgroundImageUrl

string<url>

Background image URL for the offer design.

Example:

"https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/background.png"

backgroundColor

string

Background color of the rolling offer.

Example:

"#272727"

backgroundOpacity

number

Background opacity value.

Example:

80

headerImage

string<url>

Header image URL for the rolling offer.

Example:

"https://media.appcharge.com/media/65cb7861ec8924a6b69a0f59/header.png"

arrowColor

string

Color of the arrow in the rolling offer.

Example:

"#ffffff"

borderColor

object

Color details returned by offer designs.

Show child attributes

borderWidth

number

Width of the border in pixels.

Example:

2

subRollingOffer

object

Information about the sub rolling offer configuration.

Show child attributes

backgroundExternalImageUrl

string<url>

Original background image URL for rolling offer backgrounds when an external image URL is used.

Example:

"https://cdn.example.com/assets/background.png"

Overview

What's New

Web Store

Checkout

Game Portal

Media

Events Center

Translations

Headers

Body

Response