Skip to main content
POST

Headers

x-publisher-token
string
required

Publisher token used for authentication.

Body

application/json
publisherOfferId
string
required

Reward Calendar offer ID provided by the publisher. This is the offer's External ID value in the Publisher Dashboard.

Example:

"reward-calendar-1"

name
string
required

Reward Calendar offer name.

Example:

"Weekly Reward Calendar"

type
enum<string>
required

Offer type. For Reward Calendars, use PopUp.

Available options:
PopUp
Example:

"PopUp"

subType
enum<string>
required

Popup offer subtype. For Reward Calendars, use RewardCalendar.

Available options:
RewardCalendar
Example:

"RewardCalendar"

active
boolean
required

Whether the Reward Calendar offer is active.

Example:

true

priority
integer
required

Display priority for eligible popup offers. Lower numbers appear first.

Required range: x >= 1
Example:

1

rewardCalendar
object
required

Information about the Reward Calendar behavior configuration.

productsSequence
object[]
required

A list of reward tiles. The array length must be a multiple of seven, with one to 10 configured weeks.

Required array length: 7 - 70 elements
offerUiId
string

Internal ID of the Reward Calendar offer design. Required if offerExternalUiId is not provided.

Example:

"69fb22e6dd352b799c65e97e"

offerExternalUiId
string

External ID of the Reward Calendar offer design. Required if offerUiId is not provided.

Example:

"reward-calendar-design-1"

startOver
boolean
default:true

Whether the Reward Calendar restarts from Week 1 after the player completes all configured weeks.

Example:

false

segments
string[]

A list of segments eligible for this offer.

Example:

Response

Reward Calendar offer created successfully.

publisherId
string

Internal publisher ID.

Example:

"69133d595af23405d88843a5"

publisherOfferId
string

Reward Calendar offer ID provided by the publisher. This is the offer's External ID value in the Publisher Dashboard.

Example:

"reward-calendar-1"

name
string

Reward Calendar offer name.

Example:

"Weekly Reward Calendar"

displayName
string

Reward Calendar offer display name.

Example:

"Weekly Reward Calendar"

type
enum<string>

Offer type. For Reward Calendars, use PopUp.

Available options:
PopUp
Example:

"PopUp"

subType
enum<string>

Popup offer subtype. For Reward Calendars, use RewardCalendar.

Available options:
RewardCalendar
Example:

"RewardCalendar"

active
boolean

Whether the Reward Calendar offer is active.

Example:

true

priority
integer

Display priority for eligible popup offers. Lower numbers appear first.

Required range: x >= 1
Example:

1

startOver
boolean

Whether the Reward Calendar restarts from Week 1 after the player completes all configured weeks.

Example:

true

rewardCalendar
object

Information about the Reward Calendar behavior configuration.

offerUi
object

Reward Calendar offer design details returned with the offer.

productsSequence
object[]

A list of reward tiles. The array length must be a multiple of seven, with one to 10 configured weeks.

Required array length: 7 - 70 elements
segments
string[]

A list of segments eligible for this offer.

Example:
badges
object[]

Badges attached to the offer.

offerId
string

Internal offer ID.

Example:

"69fb22e6dd352b799c65e97f"

createdAt
string<date-time>

Date the Reward Calendar offer was created.

Example:

"2026-06-11T05:09:03.575Z"

updatedAt
string<date-time>

Date the Reward Calendar offer was updated.

Example:

"2026-06-11T05:09:03.575Z"