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

# Criar Card

> Cria um novo card em um pipeline.

Cria um novo card em um estágio específico do pipeline.

<ParamField header="X-Api-Key" type="string" required>
  Sua chave de API (prefixada com `wh_`).
</ParamField>

<ParamField path="pipelineId" type="string" required>
  UUID do pipeline.
</ParamField>

### Body

<ParamField body="stageId" type="string" required>
  UUID do estágio onde o card será criado.
</ParamField>

<ParamField body="values" type="object">
  Valores dos campos do card (chave = ID do campo, valor = dado).
</ParamField>

<ParamField body="tags" type="string[]">
  Lista de tags para o card.
</ParamField>

### Exemplos de payload

<Tabs>
  <Tab title="Card básico">
    ```json theme={null}
    {
      "stageId": "stage-uuid"
    }
    ```
  </Tab>

  <Tab title="Card com valores">
    ```json theme={null}
    {
      "stageId": "stage-uuid",
      "values": {
        "name": "Maria Souza",
        "amount": 2500.00
      },
      "tags": ["enterprise", "hot"]
    }
    ```
  </Tab>
</Tabs>

<RequestExample>
  ```bash theme={null}
  curl -X POST "https://api.whatabot.app/api/v1/kanban/pipelines/pipeline-uuid/cards" \
    -H "X-Api-Key: wh_your_api_key" \
    -H "Content-Type: application/json" \
    -d '{"stageId": "stage-uuid", "values": {"name": "Maria Souza"}, "tags": ["hot"]}'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "id": "card-uuid",
    "pipelineId": "pipeline-uuid",
    "stageId": "stage-uuid",
    "sessionId": null,
    "tags": ["hot"],
    "values": {
      "name": "Maria Souza"
    },
    "createdAt": "2026-04-20T10:00:00.000Z",
    "movedAt": "2026-04-20T10:00:00.000Z"
  }
  ```
</ResponseExample>