curl -X POST https://crm.vistum.com.br/api/v1/tasks \
-H "Authorization: Bearer vg_live_SUA_CHAVE_AQUI" \
-H "Content-Type: application/json" \
-d '{
"title": "Ligar para retomar proposta",
"dueDate": "2026-07-22T13:00:00.000Z",
"type": "call",
"cardId": "card_def456ghi",
"assignedTo": "Carlos Atendente"
}'
{ "data": { "id": "task_1", "title": "Ligar para retomar proposta", "status": "pending", "dueDate": "2026-07-22T13:00:00.000Z", "...": "..." } }
Tarefas
Criar tarefa
Cria uma tarefa (follow-up com prazo), opcionalmente vinculada a um contato e/ou negócio.
POST
/
api
/
v1
/
tasks
curl -X POST https://crm.vistum.com.br/api/v1/tasks \
-H "Authorization: Bearer vg_live_SUA_CHAVE_AQUI" \
-H "Content-Type: application/json" \
-d '{
"title": "Ligar para retomar proposta",
"dueDate": "2026-07-22T13:00:00.000Z",
"type": "call",
"cardId": "card_def456ghi",
"assignedTo": "Carlos Atendente"
}'
{ "data": { "id": "task_1", "title": "Ligar para retomar proposta", "status": "pending", "dueDate": "2026-07-22T13:00:00.000Z", "...": "..." } }
Autenticação
string
required
Bearer vg_live_<sua_chave> — API Key com escopo tasks:writeBody
string
required
Título da tarefa (até 300 caracteres).
string (ISO)
required
Data/hora de vencimento. Aceita também
dueAt.string
Descrição (até 2000 caracteres).
string
Tipo livre (ex:
call, email), até 64 caracteres.string
ID de um contato do workspace.
string
ID de um negócio do workspace.
string
ID do usuário ou nome de um membro do workspace.
curl -X POST https://crm.vistum.com.br/api/v1/tasks \
-H "Authorization: Bearer vg_live_SUA_CHAVE_AQUI" \
-H "Content-Type: application/json" \
-d '{
"title": "Ligar para retomar proposta",
"dueDate": "2026-07-22T13:00:00.000Z",
"type": "call",
"cardId": "card_def456ghi",
"assignedTo": "Carlos Atendente"
}'
{ "data": { "id": "task_1", "title": "Ligar para retomar proposta", "status": "pending", "dueDate": "2026-07-22T13:00:00.000Z", "...": "..." } }
400 VALIDATION, 400 ASSIGNEE_NOT_FOUND, 400 CONTACT_NOT_FOUND, 400 CARD_NOT_FOUND, 422 NO_AUTHOR (workspace sem membros para autorar a tarefa).