Leads
Update Lead
Update an existing lead. Only provided fields are changed.
PATCH
Path Parameters
string
required
The unique identifier of the lead.
Request Body
All fields are optional. Only include the fields you want to update.string
New email address. Must be unique within the workspace.
string
First name.
string
Last name.
string
Company name.
string
Job title.
string
Phone number.
string
LinkedIn profile URL.
string
Website URL.
object
Custom key-value fields (replaces entire object).
string
Freeform notes.
string
Lead status.
Errors
Rate Limit
- 100 requests per minute, per API key. Fixed 60-second window.
- Every response includes
X-RateLimit-Limit,X-RateLimit-Remaining, andX-RateLimit-Reset(unix epoch seconds). - A
429response includes aRetry-Afterheader (seconds until the bucket resets).
Retry-After, exponential backoff, monitoring X-RateLimit-Remaining), see Rate Limiting.