Skip to main content
POST

Authorizations

x-publisher-token
string
header
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.

borderWidth
number
required

Width of the border in pixels.

Example:

2

subRollingOffer
object
required

Information about the sub rolling offer configuration.

headerImage
string<url>

Header image URL for the rolling offer.

Example:

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

Response

Offer design created successfully.

id
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.

borderWidth
number

Width of the border in pixels.

Example:

2

subRollingOffer
object

Information about the sub rolling offer configuration.

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"