curl -X PATCH https://crm.vistum.com.br/api/v1/leads/cnt_cmnl5abc123 \
-H "Authorization: Bearer vg_live_SUA_CHAVE_AQUI" \
-H "Content-Type: application/json" \
-d '{ "email": "joao.novo@empresa.com", "notes": "Atualizado via API." }'
{
"data": {
"id": "cnt_cmnl5abc123",
"name": "João Ferreira",
"phone": "5511999887766",
"email": "joao.novo@empresa.com",
"notes": "Atualizado via API."
}
}
Leads
Atualizar lead
Atualiza nome, e-mail, observações ou o conjunto de tags de um contato (lead). Envie ao menos um campo.
PATCH
/
api
/
v1
/
leads
/
{id}
curl -X PATCH https://crm.vistum.com.br/api/v1/leads/cnt_cmnl5abc123 \
-H "Authorization: Bearer vg_live_SUA_CHAVE_AQUI" \
-H "Content-Type: application/json" \
-d '{ "email": "joao.novo@empresa.com", "notes": "Atualizado via API." }'
{
"data": {
"id": "cnt_cmnl5abc123",
"name": "João Ferreira",
"phone": "5511999887766",
"email": "joao.novo@empresa.com",
"notes": "Atualizado via API."
}
}
Autenticação
string
required
Bearer vg_live_<sua_chave> — API Key com escopo leads:writeBody
Envie ao menos um campo.string | null
Nome (até 200 caracteres).
null limpa.string | null
E-mail (até 320 caracteres).
null limpa.string | null
Observações (até 10000 caracteres).
null limpa.string[]
Substitui o conjunto de tags do contato (nomes; até 20, deduplicados). Tags inexistentes são criadas. Para adicionar sem substituir, use Atribuir tag a um lead.
curl -X PATCH https://crm.vistum.com.br/api/v1/leads/cnt_cmnl5abc123 \
-H "Authorization: Bearer vg_live_SUA_CHAVE_AQUI" \
-H "Content-Type: application/json" \
-d '{ "email": "joao.novo@empresa.com", "notes": "Atualizado via API." }'
{
"data": {
"id": "cnt_cmnl5abc123",
"name": "João Ferreira",
"phone": "5511999887766",
"email": "joao.novo@empresa.com",
"notes": "Atualizado via API."
}
}
400 VALIDATION, 404 NOT_FOUND.