Criar campo personalizado

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

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.

Contatos

Empresas

Negócios

Funis de venda

Conversas

Mensagens

Tarefas

Campos personalizados

Agentes de IA

Disparos

Créditos de mensagem

Lookup

Endpoint

Corpo da requisição

Tipos de campo disponíveis

Exemplo de requisição

Resposta

​Endpoint

​Corpo da requisição

​Tipos de campo disponíveis

​Exemplo de requisição

​Resposta

Endpoint

Corpo da requisição

Tipos de campo disponíveis

Exemplo de requisição

Resposta