create raffle
POST
/v1/raffles
raffle
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST '/v1/raffles' \
--form 'file=@"C:\\Users\\Win10Pro\\Pictures\\2020-Porsche-911-Turbo-S-014-2160-scaled.jpg"' \
--form 'raffleCategoryId="4f9b1d1a-8bfa-47a6-b918-ef648df1b114"' \
--form 'title="Teste Vini Cotas"' \
--form 'subtitle="Subtítulo opcional"' \
--form 'description="Descrição do sorteio"' \
--form 'slug="{{$lorem.slug}}"' \
--form 'statusText="Status opcional"' \
--form 'privacy="PUBLIC"' \
--form 'reservationType="AUTO"' \
--form 'startsAt="{{$date.soon}}"' \
--form 'endsAt="2025-09-08T02:56:53.405Z"' \
--form 'quotaPrice="0.05"' \
--form 'quotaQuantity="10000"' \
--form 'freeCampaign="false"' \
--form 'affiliate="false"' \
--form 'fastSelectionCards="[5,10,25,50,100,1000]"' \
--form 'prizes="[{\"prize\":\"Prêmio especial 1\"}]"' \
--form 'enableQuotaPrizes="true"' \
--form 'minReservationQuantity="1"' \
--form 'maxReservationQuantity="2000"' \
--form 'reservationTimeLimit="30"' \
--form 'maxBuyerQuantity="2000"' \
--form 'showProgressBar="false"' \
--form 'showRank="false"' \
--form 'enablePromotions="true"' \
--form 'cumulative="false"' \
--form 'enableAntiSpam="false"' \
--form 'antiSpamMaxQuota="10"' \
--form 'antiSpamTimeout="30"' \
--form 'whatsapp="32772728532"' \
--form 'whatsappGroup="https://deafening-elver.biz"' \
--form 'telegram="https://pessimistic-perp.name/"' \
--form 'email="daniel.oliveira15@live.com"' \
--form 'promotionsByQuotaQuantity="[{\"quotaQuantity\":2,\"discount\":2,\"isActive\":true}]"' \
--form 'quotaPrizes="[{\"luckyNumber\":\"1\",\"prize\":\"Prêmio especial 1\",\"isLocked\":false},{\"luckyNumber\":\"2\",\"prize\":\"Prêmio especial 2\",\"isLocked\":false},{\"luckyNumber\":\"3\",\"prize\":\"Prêmio especial 3\",\"isLocked\":true}]"' \
--form 'certificateCode="123456"' \
--form 'reservationFields="[\"name\",\"phone\"]"' \
--form 'enableNotification="false"' \
--form 'automaticQuotaPrizeDistribution="true"' \
--form 'popularSelectionCard="2"' \
--form 'promotionType="BY_QUOTA_QUANTITY"' \
--form 'isHighlighted="false"' \
--form 'userId="3a64f532-ca73-4420-9dcf-527edee7a79d"'Response Response Example
201 - Success
{
"id": 11,
"message": "Rifa \"#11\" criada com sucesso."
}Request
Body Params multipart/form-data
file
file
required
Example:
file://C:\Users\Win10Pro\Pictures\2020-Porsche-911-Turbo-S-014-2160-scaled.jpg
raffleCategoryId
string
required
Example:
4f9b1d1a-8bfa-47a6-b918-ef648df1b114
title
string
required
Example:
Teste Vini Cotas
subtitle
string
required
Example:
Subtítulo opcional
description
string
required
Example:
Descrição do sorteio
slug
string
required
Example:
{{$lorem.slug}}
statusText
string
optional
Example:
Status opcional
privacy
enum<string>
required
Allowed values:
PRIVATEPUBLIC
Example:
PUBLIC
reservationType
enum<string>
required
Allowed values:
AUTOMANUAL
Example:
AUTO
startsAt
string <date>
required
Example:
{{$date.soon}}
endsAt
string <date>
required
Example:
2025-09-08T02:56:53.405Z
quotaPrice
number
required
Example:
0.05
quotaQuantity
integer
required
>= 1
Example:
10000
freeCampaign
boolean
required
Example:
false
affiliate
boolean
required
Example:
false
fastSelectionCards
string
required
Example:
[5,10,25,50,100,1000]
prizes
string
required
Example:
[{"prize":"Prêmio especial 1"}]
enableQuotaPrizes
boolean
required
Example:
true
minReservationQuantity
integer
required
>= 1
Example:
1
maxReservationQuantity
integer
required
Example:
2000
reservationTimeLimit
integer
required
Example:
30
maxBuyerQuantity
integer
required
Example:
2000
showProgressBar
boolean
required
Example:
false
showRank
boolean
required
Example:
false
enablePromotions
boolean
required
Example:
true
cumulative
boolean
required
Example:
false
enableAntiSpam
boolean
required
Example:
false
antiSpamMaxQuota
integer
optional
Example:
10
antiSpamTimeout
integer
optional
Example:
30
whatsapp
string
optional
Example:
32772728532
whatsappGroup
string
optional
Example:
https://deafening-elver.biz
telegram
string
optional
Example:
https://pessimistic-perp.name/
email
string
optional
Example:
daniel.oliveira15@live.com
promotionsByQuotaQuantity
string
optional
Example:
[{"quotaQuantity":2,"discount":2,"isActive":true}]
quotaPrizes
string
optional
Example:
[{"luckyNumber":"1","prize":"Prêmio especial 1","isLocked":false},{"luckyNumber":"2","prize":"Prêmio especial 2","isLocked":false},{"luckyNumber":"3","prize":"Prêmio especial 3","isLocked":true}]
certificateCode
string
optional
Example:
123456
reservationFields
string
required
Example:
["name","phone"]
enableNotification
boolean
required
Example:
false
automaticQuotaPrizeDistribution
boolean
required
Example:
true
popularSelectionCard
integer
required
Example:
2
promotionType
enum<string>
required
Allowed value:
BY_QUOTA_QUANTITY
Example:
BY_QUOTA_QUANTITY
isHighlighted
boolean
required
Example:
false
userId
string
required
Example:
3a64f532-ca73-4420-9dcf-527edee7a79d