Criar atividade em deal

POST/api/v1/deals/:id/activities

Cria uma atividade (tarefa, ligação, reunião) vinculada ao deal. Caso de uso clássico: n8n / Zapier criando follow-up automático ao chegar lead. typeId é opcional · quando omitido, usa o tipo marcado como default do workspace. assigneeId também opcional · default = dono do deal.

Parâmetros de path

idobrigatório

string

ID do deal (senão 404).

Body (JSON)

`title`obrigatório string	Título da atividade (1-200 caracteres).
`typeId` string	Tipo de atividade · descubra os IDs em `GET /activity-types`. Omitido = tipo default do workspace (ou o primeiro ativo). `404` se não existe ou está arquivado.
`dueAt` string (ISO 8601) \| null	Prazo · null = sem prazo.
`description` string \| null	Descrição longa opcional (max 10.000 caracteres).
`assigneeId` string \| null	Responsável · precisa ser membro do workspace (senão `404`). Omitido = dono do deal.

Headers

Idempotency-Key

string

Opcional, recomendado (8-200 caracteres, ex.: um UUID). A primeira request é processada normalmente; requests com a mesma key e mesmo body em até 24h retornam a resposta cacheada (header Idempotency-Replay: true), sem criar duplicata. Mesma key com body diferente retorna 422 IDEMPOTENCY_CONFLICT. Só respostas 2xx são cacheadas.

Resposta 201 Created.

Suporta Idempotency-Key · replays com mesmo body em até 24h retornam a resposta cacheada sem duplicar (útil pra retries de n8n/Zapier).

A atividade aparece no kanban (badge no card), na aba Atividades do deal e na timeline da IA. Dispara webhook activity.created.

Workspace sem tipos de atividade configurados retorna 502 PROVIDER_ERROR.

Autenticação: header Authorization: Bearer rmk_... · veja Introdução e autenticação.

curl -X POST "https://crmdojordao.com.br/api/v1/deals/:id/activities" \
  -H "Authorization: Bearer rmk_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{ "title": "Ligar amanhã às 9h pra confirmar reunião", "dueAt": "2026-07-16T12:00:00Z", "description": "Lead pediu pra reagendar a apresentação" }'

Request body

{
  "title": "Ligar amanhã às 9h pra confirmar reunião",
  "dueAt": "2026-07-16T12:00:00Z",
  "description": "Lead pediu pra reagendar a apresentação"
}

Resposta · POST /api/v1/deals/:id/activities

{
  "id": "act_xyz789",
  "title": "Ligar amanhã às 9h pra confirmar reunião",
  "description": "Lead pediu pra reagendar a apresentação",
  "typeId": "atype_ligacao",
  "typeName": "Ligação",
  "dueAt": "2026-07-16T12:00:00.000Z",
  "doneAt": null,
  "dealId": "deal_abc123",
  "accountId": null,
  "contactId": null,
  "assigneeId": "usr_maria",
  "authorId": null,
  "createdAt": "2026-07-15T13:30:00.000Z",
  "updatedAt": "2026-07-15T13:30:00.000Z"
}