Update a lead

curl --request PATCH \
  --url https://backend.leadey.ai/v1/leads/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "VP Revenue Operations",
  "phone": "+442071838751",
  "customFields": {
    "renewal_date": "2027-03-01",
    "fleet_size": "240"
  }
}
'

import requests

url = "https://backend.leadey.ai/v1/leads/{id}"

payload = {
    "title": "VP Revenue Operations",
    "phone": "+442071838751",
    "customFields": {
        "renewal_date": "2027-03-01",
        "fleet_size": "240"
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    title: 'VP Revenue Operations',
    phone: '+442071838751',
    customFields: {renewal_date: '2027-03-01', fleet_size: '240'}
  })
};

fetch('https://backend.leadey.ai/v1/leads/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": {
    "id": "lead_8Kq2mXvR",
    "name": "Priya Raman",
    "firstName": "Priya",
    "lastName": "Raman",
    "title": "Head of Revenue Operations",
    "company": "Northwind Logistics",
    "email": "priya.raman@northwind.co.uk",
    "phone": "+442071838750",
    "linkedinUrl": "https://www.linkedin.com/in/priyaraman",
    "status": "pending",
    "source": "linkedin-search",
    "score": 78,
    "campaignId": "fnl_Q3OutboundUK",
    "campaignName": "Q3 outbound, UK logistics",
    "createdAt": "2026-07-14T09:12:44.000Z"
  }
}

{
  "error": {
    "message": "One of email, phone or linkedinUrl is required",
    "details": null
  }
}

{
  "error": {
    "message": "Invalid or revoked API key.",
    "details": null
  }
}

{
  "error": {
    "message": "This API key is read-only. Create a key with write access in Settings → API Keys.",
    "details": null
  }
}

{
  "error": {
    "message": "Lead not found",
    "details": null
  }
}

{
  "error": {
    "message": "Rate limit exceeded. Retry in 42s.",
    "details": null
  }
}