> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sortify.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar order bump

> Cria um order bump (combo de cotas extras) em uma ação

Cria um order bump na ação. Máximo de **10 order bumps por ação**.

<Note>
  Order bumps só são exibidos no checkout de ações com seleção **aleatória** de cotas (`selection_mode: "random"`).
</Note>

## Path params

<ParamField path="id" type="string" required>ID da ação (UUID).</ParamField>

## Body

<ParamField body="title" type="string" required>Título (1–255 caracteres).</ParamField>
<ParamField body="description" type="string | null">Descrição (máx. 1000).</ParamField>
<ParamField body="extra_tickets" type="number" required>Cotas extras concedidas (mínimo 1).</ParamField>
<ParamField body="price" type="number" required>Preço fechado do combo em **centavos** (ex.: `990` = R\$ 9,90).</ParamField>
<ParamField body="display_order" type="number" default="0">Ordem de exibição.</ParamField>
<ParamField body="is_active" type="boolean" default="true">Se o combo aparece no checkout.</ParamField>

## Erros

| HTTP  | Código                     | Quando ocorre                               |
| ----- | -------------------------- | ------------------------------------------- |
| `404` | `RAFFLE_NOT_FOUND`         | Ação inexistente ou de outra conta          |
| `400` | `ORDER_BUMP_LIMIT_REACHED` | Já existem 10 order bumps na ação           |
| `422` | `VALIDATION`               | Formato inválido (extra\_tickets \< 1 etc.) |

<RequestExample>
  ```bash curl theme={null}
  curl -u "pb_xxx:sk_xxx" -X POST \
    -H "Content-Type: application/json" \
    -d '{
      "title": "Dobre suas chances",
      "description": "Leve 20 cotas extras",
      "extra_tickets": 20,
      "price": 990
    }' \
    "https://api.sortify.com.br/v1/raffles/{id}/order-bumps"
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "success": true,
    "message": "Order bump criado com sucesso",
    "data": {
      "id": "1a2b3c4d-5e6f-7a8b-9c0d-e1f2a3b4c5d6",
      "title": "Dobre suas chances",
      "description": "Leve 20 cotas extras",
      "extra_tickets": 20,
      "price": 990,
      "is_active": true,
      "display_order": 0,
      "created_at": "2026-07-06T12:00:00.000Z",
      "updated_at": "2026-07-06T12:00:00.000Z"
    }
  }
  ```
</ResponseExample>