Raw schema
{
"type": "object",
"properties": {
"date": {
"type": "string",
"format": "date",
"description": "Date of the draw, in YYYY-MM-DD format."
},
"participants": {
"type": "array",
"minItems": 3,
"description": "Minimum 3 participants. The first is the organizer.",
"items": {
"type": "object",
"required": [
"name",
"email"
],
"properties": {
"name": {
"type": "string",
"maxLength": 255
},
"email": {
"type": "string",
"format": "email"
},
"exclusions": {
"type": "array",
"items": {
"type": "string",
"format": "email"
},
"description": "Optional. Emails of the participants this participant is not paired with (e.g. their partner)."
}
}
}
},
"drawName": {
"type": "string",
"maxLength": 255,
"description": "Optional. If omitted, a localized default is generated (e.g. \"Amigo Invisible 2026\", \"Amigo Secreto 2026\", \"Intercambio de regalos 2026\", or \"Secret Santa 2026\")."
},
"price": {
"type": "string",
"description": "Optional gift budget, free text. Examples: \"20€\", \"$25\"."
},
"message": {
"type": "string",
"description": "Optional invitation email body. If omitted, a localized default is used. The placeholder \"ParticipanteX\" is replaced with each recipient name."
},
"locale": {
"type": "string",
"description": "Optional BCP 47 language tag for the user (e.g. \"es-ES\", \"es-MX\", \"es-AR\", \"en-GB\"). It determines the Secret Santa Raffle brand (website) and the language of the message templates and emails: arguments.locale takes precedence, then the Accept-Language header, then Secret Santa (English) when neither is present or supported. Brands: Amigo Invisible (Spain/Argentina/Uruguay), Amigo Secreto (most of Latin America), Intercambio de regalos (Mexico), Secret Santa (English and global fallback)."
}
},
"required": [
"date",
"participants"
]
}