Skip to main content

​
Endpoint

PATCH /v1/contacts/:id
Escopo necessário: write:contacts Envie apenas os campos que deseja alterar. Campos não incluídos no corpo permanecem inalterados.

​
Parâmetros de path

ParâmetroTipoDescrição
idstringID do contato

​
Corpo da requisição

CampoTipoDescrição
namestringNome completo
emailstring|nullEmail (envie null para limpar)
phonestring|nullTelefone (envie null para limpar)
instagram_usernamestring|nullUsername do Instagram
messenger_psidstring|nullPSID do Messenger
company_idstring|nullID da empresa (envie null para desvincular)
assigned_tostring|nullID do membro responsável (null para desatribuir)
tagsstring[]Substitui completamente a lista de tags
custom_fieldsobjectSubstitui completamente os campos personalizados
funnel_stagestring|nullEtapa no funil de contatos

​
Exemplo de requisição

curl -X PATCH https://api.socialsell.ai/v1/contacts/664f1a2b3c4d5e6f78901234 \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "email": "novo@email.com.br",
    "tags": ["cliente", "vip", "enterprise"],
    "assigned_to": "664a1b2c3d4e5f6789012345"
  }'

​
Exemplo de resposta

{
  "data": {
    "id": "664f1a2b3c4d5e6f78901234",
    "name": "João Silva",
    "email": "novo@email.com.br",
    "tags": ["cliente", "vip", "enterprise"],
    "assigned_to": {
      "id": "664a1b2c3d4e5f6789012345",
      "name": "Maria Santos"
    },
    "updated_at": "2026-06-10T16:00:00.000Z"
  },
  "meta": {
    "request_id": "req_01jx8kz3m4n5p6q7r8s9t0u1v"
  }
}
A atualização dispara o evento contact.updated em webhooks configurados.
Os campos tags e custom_fields substituem os valores anteriores por completo. Para adicionar uma tag sem perder as existentes, use o endpoint dedicado Adicionar tag.

​
Erros

CódigoStatusDescrição
INVALID_ID400ID com formato inválido
NOT_FOUND404Contato não encontrado