Endpoint
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
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.
key, type e entity não podem ser alterados após a criação. Defina-os com cuidado.
