FOfourthwall
Gifting

Update gifting config

Changed on

Writes the four creator-controlled gifting rule fields. Validation (duration 20-180s, valid shipping/products) and the one-platform-per-shop mutex are enforced server-side. Upserts: a first-ever PUT materializes the config row.

put/open-api/v1.0/gifting/config

Request

  • Base URL
    https://api.fourthwall.com
  • URL
    https://api.fourthwall.com/open-api/v1.0/gifting/config
  • Auth
    • OAuth 2
      Implicit: https://auth.staging.fourthwall.com/auth/realms/Fourthwall/protocol/openid-connect/auth
      Scopes: giveaway_write
    • or HTTP basic

Request body

enabledboolean required

Master flag. Off pauses purchasability without losing the rest.

entryTimeLimitSecondsinteger required

Entry time limit in seconds. Validated 20-180.

Response

OK

enabledboolean required

Master "gift while live" flag.

entryTimeLimitSecondsinteger required

Entry time limit in seconds (20-180), maps to the giveaway duration.

platform'TWITCH' | 'STREAMELEMENTS' | 'OPEN_API' | 'NOT_SELECTED' required

Current giveaway platform owning the shop's single gifting slot. Read-only conflict signal — TWITCH or STREAMELEMENTS means another integration owns the slot. A Kick shop operates on the OPEN_API slot.

Changes