CRM do JordãoCRM do JordãoCentral de Ajuda

Sincronizar uma nota de deal

PUT/api/v1/deals/:id/notes

Cria ou atualiza sempre a mesma nota de uma integração. A identidade combina a API key com externalId, evitando duplicatas em retries e em execuções concorrentes.

Parâmetros de path

idobrigatório
string
ID do deal (senão 404).

Body (JSON)

externalIdobrigatório
string
Identificador estável da nota no sistema de origem (1-200 caracteres).
bodyobrigatório
string
Conteúdo completo que substituirá a versão anterior (1-1.000.000 caracteres).
Resposta 201 Created na primeira gravação e 200 OK nas seguintes.
Se o corpo não mudou, changed vem false e a nota não é reescrita.
A mesma API key não cria mais de uma nota para o mesmo externalId.

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

curl -X PUT "https://crmdojordao.com.br/api/v1/deals/:id/notes" \
  -H "Authorization: Bearer rmk_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{ "externalId": "conversation-history:lead_123", "body": "CONVERSA COMPLETA\n\n21/09/2026\n[08:31] Lead: Obrigado" }'
Request body
{
  "externalId": "conversation-history:lead_123",
  "body": "CONVERSA COMPLETA\n\n21/09/2026\n[08:31] Lead: Obrigado"
}
Resposta · PUT /api/v1/deals/:id/notes
{
  "id": "note_xyz456",
  "body": "CONVERSA COMPLETA\n\n21/09/2026\n[08:31] Lead: Obrigado",
  "dealId": "deal_abc123",
  "contactId": null,
  "accountId": null,
  "authorId": "usr_maria",
  "createdAt": "2026-07-15T13:30:00.000Z",
  "updatedAt": "2026-09-21T11:00:00.000Z",
  "created": false,
  "changed": true
}