Tags de contato

Adicionar tag

POST /v1/contacts/:id/tags

Escopo necessário: write:tags Adiciona uma tag ao contato sem remover as tags existentes (usa $addToSet internamente — não duplica).

Corpo da requisição

Campo	Tipo	Obrigatório	Descrição
`tag`	string	Sim	Nome da tag a adicionar

Exemplo

curl -X POST https://api.socialsell.ai/v1/contacts/664f1a2b3c4d5e6f78901234/tags \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"tag": "enterprise"}'

Resposta

Retorna o contato atualizado com a nova tag incluída.

Remover tag

DELETE /v1/contacts/:id/tags/:tag

Escopo necessário: write:tags Remove uma tag específica do contato.

Exemplo

curl -X DELETE "https://api.socialsell.ai/v1/contacts/664f1a2b3c4d5e6f78901234/tags/enterprise" \
  -H "Authorization: Bearer sk_live_..."

Resposta

Retorna o contato atualizado sem a tag removida.

Para substituir todas as tags de um contato, use PATCH /v1/contacts/:id com o campo tags.

Tag informada pelo nome que ainda não existe na organização é criada ao adicionar. Já na remoção, um nome desconhecido não cria nada — simplesmente não há o que remover.

Adicionar e remover tag disparam os webhooks contact.tag.added e contact.tag.removed.

Erros

Código	Status	Descrição
`INVALID_ID`	`400`	ID com formato inválido
`MISSING_TAG`	`400`	Campo `tag` ausente
`NOT_FOUND`	`404`	Contato não encontrado

Contatos

Empresas

Negócios

Funis de venda

Conversas

Mensagens

Tarefas

Campos personalizados

Agentes de IA

Disparos

Créditos de mensagem

Lookup

Adicionar tag

Corpo da requisição

Exemplo

Resposta

Remover tag

Exemplo

Resposta

Erros

​Adicionar tag

​Corpo da requisição

​Exemplo

​Resposta

​Remover tag

​Exemplo

​Resposta

​Erros

Adicionar tag

Corpo da requisição

Exemplo

Resposta

Remover tag

Exemplo

Resposta

Erros