Add Lead Notes
POST/v1/open-api/lead-note/:leadId/list
Add 1–10 notes to a lead. Processed asynchronously — returns a requestId.
Requires grant PERMISSION_OPEN_API_LEAD_NOTE:SAVE.
Request
Responses
- 200
- 400
- 401
- 403
- 429
Request accepted and enqueued. Poll requestId for the result.
Validation error (400). Field-level failures are listed in errors[] and error is
null; a malformed / unparsable JSON body is the inverse — error.messageCode is
3705 and errors[] is empty.
Invalid, revoked or expired token (401) — also returned when the connection was
revoked or the company is blocked.
Produced by the authentication filter, so the body is a reduced envelope: no
error, no requestId, and errors is null rather than []. Every cause yields the
same fixed English message.
The token lacks the required permission:scope grant (403).
Rate limit of 60 requests/minute exceeded (429). Like 401, this comes from the
authentication filter: reduced envelope, fixed English message, no error object and no
Retry-After header.