Sign in

v2

latestOpenAPI 3.1.02026-07-26102336742.6 KB
Gifting

Finish draw

Rate limit: 100 requests / 10 seconds per shop. See Rate limiting.

Finish draw and select winners

put/open-api/v1.0/gifting/draw/{id}/finish

Path parameters

idstring required

Request body

Response

OK

idstring required
type'INITIAL' | 'REDO' required
giveawayIdstring required
giveawayFriendlyIdstring required
shopIdstring required
emailstring required
usernamestring
messagestring
createdAtstring date-time required
durationSecondsinteger required

Example response

{
  "id": "gdr_EdJvIXu3SEiXe_QkPavHSA",
  "giveawayId": "giv_EdJvIXu3SEiXe_QkPavHSA",
  "giveawayFriendlyId": "D3XZFWPP",
  "shopId": "sh_c689d374-22ca-43d3-8d29-9ef0805cc4cb",
  "offer": {
    "id": "00aa4abd-5778-4199-8161-0b49b2f212e5",
    "name": "My t-shirt",
    "slug": "my-t-shirt",
    "description": "My t-shirt description",
    "primaryImage": {
      "id": "00aa4abd-5778-4199-8161-0b49b2f212e5",
      "url": "https://fourthwall.com/image.png",
      "width": 800,
      "height": 600,
      "transformedUrl": "https://fourthwall.com/image.png"
    }
  },
  "amounts": {
    "subtotal": {
      "value": 10,
      "currency": "USD"
    },
    "total": {
      "value": 10,
      "currency": "USD"
    }
  },
  "email": "supporter@fourthwall.com",
  "username": "Johnny123",
  "message": "Sample message",
  "gifts": [
    {
      "id": "gft_EdJvIXu3SEiXe_QkPavHSA",
      "winner": {
        "email": "supporter@fourthwall.com",
        "username": "Johnny123",
        "selectedAt": "2020-08-13T09:05:36.939Z"
      }
    }
  ]
}