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.