Skip to main content

​
Endpoint

PUT /backend/leads/{id}

​
Path Parameters

​
id
string
required
Lead ID

​
Body Parameters

​
name
string
Lead’s full name
​
phone
string
Phone with country code
​
email
string
Email address
​
company
string
Company name
​
status_id
string
Status ID
​
custom_fields
object
Custom field values

​
Request Example

curl -X PUT "https://api.leavo.ai/backend/leads/lead-uuid" \
  -H "Authorization: Bearer your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Smith Jr",
    "company": "New Company",
    "status_id": "new-status-uuid"
  }'

​
Response

{
  "success": true,
  "data": {
    "id": "lead-uuid",
    "name": "John Smith Jr",
    "phone": "+15551234567",
    "email": "[email protected]",
    "company": "New Company",
    "status": {
      "id": "new-status-uuid",
      "name": "Qualified",
      "color": "#3B82F6"
    },
    "updated_at": "2024-01-15T14:00:00Z"
  }
}