Skip to main content
POST
https://crm.uservox.ai/api/v1
/
leads
/
update
Update Lead
curl --request POST \
  --url https://crm.uservox.ai/api/v1/leads/update \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "leadId": "<string>",
  "referenceId": "<string>",
  "projectId": "<string>",
  "processId": "<string>",
  "metadata": {},
  "name": "<string>",
  "targetState": "<string>",
  "disposition": "<string>",
  "userId": "<string>"
}
'
{
  "success": true,
  "lead": {
    "_id": "<string>",
    "name": "<string>",
    "phone": "<string>",
    "email": "<string>",
    "projectId": "<string>",
    "processId": "<string>",
    "currentState": "<string>",
    "metadata": {},
    "createdAt": "<string>",
    "updatedAt": "<string>"
  }
}

​
Body Parameters

​
leadId
string
MongoDB ObjectId of the lead (required if not using referenceId)
​
referenceId
string
External reference ID (requires projectId and processId)
​
projectId
string
Required when using referenceId
​
processId
string
Required when using referenceId
​
metadata
object
Metadata object to merge with existing metadata
​
name
string
Update the lead’s name
​
targetState
string
Target state to transition the lead to (e.g., “interested”, “lost”, “followup_2”)
​
disposition
string
Disposition reason (used with targetState “interested” or “lost”)
​
userId
string
User ID for audit logging
If metadata is not provided, all other fields (except leadId, referenceId, projectId, processId, targetState, name, disposition, userId) will be merged into metadata.

​
Response

​
success
boolean
Indicates if the request was successful
​
lead
object
The updated lead object