Create or update a lead
POST/v1/open-api/lead
Create a new lead, or update an existing one (distinguished by id). Processed
asynchronously — the endpoint returns a requestId to poll for the outcome.
Updates are partial down to the item level: absent keys (including keys inside
each contacts[] / fields[] item) are left unchanged, values update, and explicit
null clears. However, the contacts and fields lists themselves are sent in
full — when present they replace the whole set, so contacts/field-values missing
from the list are unlinked/deleted. See LeadCreateRequestDTO for the full rules.
Requires grant PERMISSION_OPEN_API_LEAD:SAVE.
Request
Responses
- 200
- 400
- 401
- 403
- 429
Request accepted and enqueued. Poll requestId for the result.
Validation error (400).
Invalid, revoked or expired token (401).
The token lacks the required permission:scope grant (403).
Rate limit of 60 requests/minute exceeded (429).