Skip to main content
PUT
/
raffles
/
{id}
Update raffle
curl --request PUT \
  --url https://api.sprucecollective.co.uk/raffles/{id} \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "active": true,
  "allow_free_entries": true,
  "archived": true,
  "campaign_name": "<string>",
  "checkout_description": "<string>",
  "checkout_failure_url": "<string>",
  "checkout_success_url": "<string>",
  "closed": true,
  "collection_id": "<string>",
  "cta_text": "<string>",
  "currency": "<string>",
  "description": "<string>",
  "details": "<string>",
  "discount_tiers": [
    {
      "discount": 123,
      "min_quantity": 123
    }
  ],
  "draft": true,
  "end_date": "<string>",
  "final_cta_description": "<string>",
  "final_cta_heading": "<string>",
  "giveaway_type": "<string>",
  "hero_description": "<string>",
  "hero_header": "<string>",
  "image_gallery": "<string>",
  "item_id": "<string>",
  "last_person_who_brought": "<string>",
  "locale_id": "<string>",
  "long_description": "<string>",
  "main_image": "<string>",
  "max_entries": 123,
  "name": "<string>",
  "points_enabled": true,
  "points_multiplier": 123,
  "points_required": 123,
  "price_display": 123,
  "quick_buy_options": "<string>",
  "quick_wins": "<string>",
  "revolut_product_id": "<string>",
  "sendgrid_email_params": {
    "brand_logo_url": "<string>",
    "brand_name": "<string>",
    "brand_site_url": "<string>",
    "color_accent": "<string>",
    "color_bg": "<string>",
    "color_button_text": "<string>",
    "color_footer_text": "<string>",
    "color_text_primary": "<string>",
    "currency": "<string>",
    "current_year": "<string>",
    "email_title": "<string>",
    "first_name": "<string>",
    "from_email": "<string>",
    "from_name": "<string>",
    "giveaway_name": "<string>",
    "language": "<string>",
    "plural": true,
    "reply_to_email": "<string>",
    "ticket_quantity": "<string>",
    "unsubscribe": "<string>",
    "unsubscribe_preferences": "<string>"
  },
  "short_teaser": "<string>",
  "slug": "<string>",
  "start_date": "<string>",
  "total_entries_available": 123,
  "upsells": [
    {
      "discount": 123,
      "percentage": 123,
      "qty": 123,
      "quantity": 123
    }
  ],
  "webflow_site_id": "<string>",
  "what_you_can_win_1": "<string>",
  "what_you_can_win_2": "<string>",
  "what_you_can_win_3": "<string>",
  "what_you_can_win_4": "<string>",
  "winner_names": "<string>",
  "worth_subline": "<string>",
  "worth_total": "<string>"
}
'
{
  "active": true,
  "allow_free_entries": true,
  "archived": true,
  "campaign_name": "<string>",
  "can_join": true,
  "checkout_description": "<string>",
  "checkout_failure_url": "<string>",
  "checkout_success_url": "<string>",
  "closed": true,
  "collection_id": "<string>",
  "created_at": "<string>",
  "cta_text": "<string>",
  "currency": "<string>",
  "current_entries": 123,
  "description": "<string>",
  "details": "<string>",
  "discount_tiers": [
    {
      "discount": 123,
      "min_quantity": 123
    }
  ],
  "draft": true,
  "drawn_at": "<string>",
  "end_date": "<string>",
  "entries_purchased": 123,
  "final_cta_description": "<string>",
  "final_cta_heading": "<string>",
  "giveaway_type": "<string>",
  "hero_description": "<string>",
  "hero_header": "<string>",
  "id": "<string>",
  "image_gallery": "<string>",
  "is_active": true,
  "is_drawn": true,
  "item_id": "<string>",
  "last_person_who_brought": "<string>",
  "locale_id": "<string>",
  "long_description": "<string>",
  "main_image": "<string>",
  "max_entries": 123,
  "name": "<string>",
  "points_required": 123,
  "price_display": 123,
  "published_on": "<string>",
  "quick_buy_options": "<string>",
  "quick_wins": "<string>",
  "revolut_product_id": "<string>",
  "sendgrid_email_params": {
    "brand_logo_url": "<string>",
    "brand_name": "<string>",
    "brand_site_url": "<string>",
    "color_accent": "<string>",
    "color_bg": "<string>",
    "color_button_text": "<string>",
    "color_footer_text": "<string>",
    "color_text_primary": "<string>",
    "currency": "<string>",
    "current_year": "<string>",
    "email_title": "<string>",
    "first_name": "<string>",
    "from_email": "<string>",
    "from_name": "<string>",
    "giveaway_name": "<string>",
    "language": "<string>",
    "plural": true,
    "reply_to_email": "<string>",
    "ticket_quantity": "<string>",
    "unsubscribe": "<string>",
    "unsubscribe_preferences": "<string>"
  },
  "short_teaser": "<string>",
  "slug": "<string>",
  "start_date": "<string>",
  "total_entries_available": 123,
  "updated_at": "<string>",
  "upsells": [
    {
      "discount": 123,
      "percentage": 123,
      "qty": 123,
      "quantity": 123
    }
  ],
  "webflow_site_id": "<string>",
  "what_you_can_win_1": "<string>",
  "what_you_can_win_2": "<string>",
  "what_you_can_win_3": "<string>",
  "what_you_can_win_4": "<string>",
  "winner_names": "<string>",
  "worth_subline": "<string>",
  "worth_total": "<string>"
}

Authorizations

Authorization
string
header
required

Type "Bearer" followed by a space and JWT token.

Path Parameters

id
string
required

Raffle ID

Body

application/json

Raffle update data

active
boolean
allow_free_entries
boolean
archived
boolean
campaign_name
string
checkout_description
string
checkout_failure_url
string
checkout_success_url
string
closed
boolean
collection_id
string
cta_text
string
currency
string
description
string
details
string
discount_tiers
object[]

DiscountTiers specifies bulk purchase discounts. Each tier is an object with min_quantity and discount (e.g., 0.10 for 10% off).

draft
boolean
end_date
string
final_cta_description
string
final_cta_heading
string
giveaway_type
string
hero_description
string
hero_header
string
item_id
string
last_person_who_brought
string
locale_id
string
long_description
string
main_image
string
max_entries
integer
name
string
points_enabled
boolean
points_multiplier
number
points_required
integer
price_display
number
quick_buy_options
string
quick_wins
string
revolut_product_id
string
sendgrid_email_params
object

SendGrid email parameters for email templates

short_teaser
string
slug
string
start_date
string
total_entries_available
integer
upsells
object[]

Upsells specifies upsell offers for checkout. Each upsell is an object with qty and percentage (e.g., 0.15 for 15% off).

webflow_site_id
string

Webflow site identifier for multi-site support

what_you_can_win_1
string
what_you_can_win_2
string
what_you_can_win_3
string
what_you_can_win_4
string
winner_names
string
worth_subline
string
worth_total
string

Response

OK

active
boolean
allow_free_entries
boolean
archived
boolean
campaign_name
string
can_join
boolean
checkout_description
string
checkout_failure_url
string
checkout_success_url
string
closed
boolean
collection_id
string
created_at
string
cta_text
string
currency
string
current_entries
integer
description
string
details
string
discount_tiers
object[]
draft
boolean
drawn_at
string
end_date
string
entries_purchased
integer
final_cta_description
string
final_cta_heading
string
giveaway_type
string
hero_description
string
hero_header
string
id
string
is_active
boolean
is_drawn
boolean
item_id
string
last_person_who_brought
string
locale_id
string
long_description
string
main_image
string
max_entries
integer
name
string
points_required
integer
price_display
number
published_on
string
quick_buy_options
string
quick_wins
string
revolut_product_id
string
sendgrid_email_params
object
short_teaser
string
slug
string
start_date
string
total_entries_available
integer
updated_at
string
upsells
object[]
webflow_site_id
string
what_you_can_win_1
string
what_you_can_win_2
string
what_you_can_win_3
string
what_you_can_win_4
string
winner_names
string
worth_subline
string
worth_total
string