Secret Santa Raffle

Creates a Secret Santa / Amigo Invisible / Amigo Secreto / gift exchange draw and pairs the participants randomly, honouring exclusion rules (e.g. couple-couple, sibling-sibling). The first participant in the list is the organizer. The required inputs are the date and at least 3 participants; the budget, the exclusions, a personal invitation message and the locale are optional. The draw is created immediately and cannot be modified from this server afterwards. The result returns the draw id and its share code, and lists two ways to invite the participants: send_invitations_email (an email to each participant) or get_group_share_message (a message to paste into a group chat).

{
  "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"
  ]
}

{
  "type": "object",
  "properties": {
    "drawId": {
      "type": "integer"
    },
    "shareCode": {
      "type": "string"
    },
    "drawName": {
      "type": "string"
    },
    "participantCount": {
      "type": "integer",
      "minimum": 0
    },
    "organizerName": {
      "type": "string"
    },
    "brand": {
      "type": "string",
      "enum": [
        "AI",
        "AS",
        "MX",
        "SS"
      ]
    },
    "date": {
      "type": "string",
      "format": "date"
    },
    "price": {
      "type": "string"
    },
    "widgetLabels": {
      "type": "object"
    }
  },
  "required": [
    "drawId",
    "shareCode",
    "drawName",
    "participantCount",
    "organizerName",
    "brand",
    "date"
  ]
}

Sends the email invitation to all participants of a draw created in this same conversation. Each participant receives a personal email invitation. The send is immediate and cannot be recalled; a draw admits one bulk send. Takes the drawId and shareCode returned by create_draw.

{
  "type": "object",
  "properties": {
    "drawId": {
      "type": "integer",
      "minimum": 1
    },
    "shareCode": {
      "type": "string",
      "minLength": 1,
      "description": "Access credential of the draw, returned by create_draw (structuredContent.shareCode). Whoever holds it can send the invitations of that draw."
    },
    "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": [
    "drawId",
    "shareCode"
  ]
}

{
  "type": "object",
  "properties": {
    "drawId": {
      "type": "integer"
    },
    "invitationsSent": {
      "type": "boolean"
    },
    "brand": {
      "type": "string",
      "enum": [
        "AI",
        "AS",
        "MX",
        "SS"
      ]
    }
  },
  "required": [
    "drawId",
    "invitationsSent",
    "brand"
  ]
}

Generates a ready-to-paste WhatsApp/Telegram message announcing a freshly created draw, which the user copies into the relevant chat. Localized in Spanish (Spain), Spanish (Latin America), Spanish (Mexico) or English according to the brand. It is the alternative to send_invitations_email for sharing without emails: nothing is sent.

{
  "type": "object",
  "properties": {
    "drawName": {
      "type": "string",
      "minLength": 1
    },
    "organizerName": {
      "type": "string",
      "minLength": 1,
      "description": "Usually the first participant of the draw (the organizer)."
    },
    "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": [
    "drawName",
    "organizerName"
  ]
}

{
  "type": "object",
  "properties": {
    "messageText": {
      "type": "string"
    },
    "brand": {
      "type": "string",
      "enum": [
        "AI",
        "AS",
        "MX",
        "SS"
      ]
    },
    "locale": {
      "type": "string"
    }
  },
  "required": [
    "messageText",
    "brand"
  ]
}