---
title: "Create or update giveaway"
method: PUT
path: "/open-api/v1.0/giveaways/giveaway-checkout"
tags: ["Giveaways"]
---

# Create or update giveaway

`PUT /open-api/v1.0/giveaways/giveaway-checkout`

## Request

- Base URL: `https://api.fourthwall.com`
- URL: `https://api.fourthwall.com/open-api/v1.0/giveaways/giveaway-checkout`
- Auth: one of:
  - OAuth 2
    - Implicit: `https://auth.staging.fourthwall.com/auth/realms/Fourthwall/protocol/openid-connect/auth`
    - Scopes: `giveaway_write`
  - HTTP basic

*Rate limit: 100 requests / 10 seconds per shop. See [Rate limiting](/guides/rate-limiting).*

Creates a new giveaway or updates existing one

## Request body

- ComFourthwallAppOpenapiEndpointOpenApiGiveawayEndpointCreateGiveawayCheckoutXRequest
  - `heading` string, required
  - `description` string, required
  - `iconUrl` string, required
  - `buttonText` string, required
  - `disabled` boolean

## Response `200`

OK

## Other responses

- `429`: Rate limited: 100 requests / 10 seconds per shop.

## Changes

- **2026-07-21** `d02dd5a76313`: 1 info
  - added the non-success response with the status `429`

[Operation history](https://skmtc.dev/fourthwall/apis/fourthwall-apis-2/changes/open-api/v1.0/giveaways/giveaway-checkout/put.md)

---

[API](https://skmtc.dev/fourthwall/apis/fourthwall-apis-2.md) - [All operations](https://skmtc.dev/fourthwall/apis/fourthwall-apis-2/llms.txt) - [OpenAPI document](https://skmtc.dev/fourthwall/apis/fourthwall-apis-2/revisions/77de1061d5c9?raw)