Criar contato

Cria um contato na conta e devolve 201 com o registro criado.

POST https://app.salos.com.br/api/contacts contacts:write

Corpo de exemplo

{
  "name": "Maria Souza",
  "email": "maria@exemplo.com.br",
  "phone": "+55 11 97777-0002",
  "title": "Diretora"
}

Campos

Campo Tipo Criar Regras
name texto obrigatório 1–120 caracteres
email texto | null opcional e-mail válido, até 200
phone texto | null opcional até 40
title texto | null opcional cargo, até 120
company_id uuid | null opcional precisa existir na conta
notes texto | null opcional até 5000. Só escrita — vira uma anotação
instagram texto | null opcional usuário do Instagram, até 255
messenger_id texto | null opcional id do Messenger, até 255
external_id texto | null opcional até 255. O id deste contato no seu sistema — é o que faz a carga ser reexecutável. Já usado por outro contato: 409 com o existing_id
custom_fields objeto opcional {"<key ou uuid>": valor} dos campos personalizados de contato. Chave inexistente ou valor de tipo errado é 400 nomeando a chave
tag_ids lista de uuid opcional vincula etiquetas já na criação — cada uma precisa existir nesta conta e se aplicar a contato. Uma etiqueta ruim (de outra conta, ou que não se aplica) recusa a chamada inteira: nenhum contato é criado

Não existe "contato bloqueado"

Se você está migrando de um CRM que tem situação de contato (bloqueado, arquivado, opt-out) — o Salos não tem esse conceito. Traga o contato como um contato comum: não existe campo de situação nesta API, e não existe mapeamento pra "bloqueado" ou "arquivado" do sistema de origem. Todo contato importado entra ativo, visível na lista e alcançável pelo agente de IA.

Não crie o mesmo contato duas vezes

Mande o cabeçalho Idempotency-Key com um valor seu. Se a mesma chave chegar de novo — retentativa automática da sua ferramenta, timeout de proxy — a resposta é a mesma de antes, e nada é duplicado.