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

# Criar campo personalizado

> Cria um novo campo personalizado para contatos, empresas ou negócios.

## Endpoint

```
POST /v1/custom-fields
```

**Escopo necessário:** `write:custom_fields`

## Corpo da requisição

| Campo           | Tipo    | Obrigatório | Descrição                                                                   |
| --------------- | ------- | ----------- | --------------------------------------------------------------------------- |
| `key`           | string  | Sim         | Chave única. Apenas minúsculas, dígitos e `_`, iniciando com letra. Máx. 50 |
| `label`         | string  | Sim         | Rótulo de exibição. Máx. 100                                                |
| `type`          | string  | Sim         | Tipo do campo (ver tabela abaixo)                                           |
| `entity`        | string  | Sim         | `contact`, `company` ou `deal`                                              |
| `options`       | array   | Não         | Opções para `select`/`multiselect`. Strings ou `{value, label}`             |
| `default_value` | any     | Não         | Valor padrão                                                                |
| `required`      | boolean | Não         | Se é obrigatório                                                            |

## Tipos de campo disponíveis

| Tipo          | Descrição        |
| ------------- | ---------------- |
| `text`        | Texto curto      |
| `textarea`    | Texto longo      |
| `number`      | Número           |
| `currency`    | Valor monetário  |
| `date`        | Data             |
| `datetime`    | Data e hora      |
| `boolean`     | Verdadeiro/falso |
| `select`      | Seleção única    |
| `multiselect` | Seleção múltipla |
| `url`         | URL              |
| `email`       | E-mail           |
| `phone`       | Telefone         |

## Exemplo de requisição

```bash theme={null}
curl -X POST https://api.socialsell.ai/v1/custom-fields \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "key": "origem_lead",
    "label": "Origem do Lead",
    "type": "select",
    "entity": "contact",
    "options": ["Site", "Indicação", "Evento", "Anúncio"]
  }'
```

## Resposta

Retorna `HTTP 201` com o campo criado.

<Warning>
  `key`, `type` e `entity` não podem ser alterados após a criação. Defina-os com cuidado.
</Warning>