Criar nota em deal

POST/api/v1/deals/:id/notes

Anota contexto adicional num deal. A nota vai pro timeline visível ao vendedor e também alimenta o event log usado pela IA.

Parâmetros de path

idobrigatório

string

ID do deal (senão 404).

Body (JSON)

bodyobrigatório

string

Texto da nota (1-10.000 caracteres).

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).

Dispara webhook note.created.

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

curl -X POST "https://crmdojordao.com.br/api/v1/deals/:id/notes" \
  -H "Authorization: Bearer rmk_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{ "body": "Lead respondeu pesquisa NPS com nota 9. Bom sinal pra escalar." }'

Request body

{
  "body": "Lead respondeu pesquisa NPS com nota 9. Bom sinal pra escalar."
}

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

{
  "id": "note_xyz456",
  "body": "Lead respondeu pesquisa NPS com nota 9. Bom sinal pra escalar.",
  "dealId": "deal_abc123",
  "contactId": null,
  "accountId": null,
  "authorId": "usr_maria",
  "createdAt": "2026-07-15T13:30:00.000Z",
  "updatedAt": "2026-07-15T13:30:00.000Z"
}