Create a new giveaway

Create a giveaway that automatically enters tippers during the specified window.

Authentication required: Account JWT (Bearer token) must be provided.

Tips to ANY of the creator's earning wallets (smart_account rows) during the giveaway window will create entries. The giveaway is tied to the authenticated account, not a specific wallet address.

Management operations (update, draw, cancel) require the same account JWT used to create the giveaway. Only the creator can manage their giveaway.

Currently limited to USDC tips on Base and Base Sepolia networks.

authorizationstring nullable

Bearer <account_jwt>

Request body

titlestring required

Short title for the giveaway

descriptionstring required

Description of the giveaway and prizes

start_atstring date-time required

When the giveaway starts accepting entries (must be in the future)

end_atstring date-time required

When the giveaway stops accepting entries

allow_multiple_entriesboolean

If true, floor(tip_amount / min_tip) = number of entries. If false, 1 entry per qualifying tip.

num_winnersinteger

Number of winners to draw

selection_mode'random' | 'manual'

How winners are selected for a giveaway.

networkstring

Network for the giveaway (must match tip network for entries to be created)

Example request

{
  "title": "Win an exclusive NFT!",
  "description": "Win exclusive NFT for tipping during January!",
  "network": "base"
}

Response

Successful Response

v1

Create a new giveaway

Headers

Request body

Example request

Response