OpenapiV1LeadsId
Update lead
Update fields on an existing lead.
Only provided fields will be updated; all others remain unchanged.
Updatable fields:
full_name,email,phone,company,status,timezone,notes
Path Parameters
idstring
Lead ID (UUID)
Format
uuidcompany?string
Company name
email?string
Email address
Format
emailfull_name?string
Full name of the lead
notes?
Internal notes attached to the lead. See the LeadNotes schema for the array shape (each note has content + created_at + optional user_id). Replaces the existing notes array. Pass null or omit to skip.
phone?string
Phone number in E.164 format (validated): + followed by country code and digits, no spaces or hyphens.
Match
^\+[1-9]\d{1,14}$status?string
Lead status
timezone?string
Lead's timezone (IANA format)
Response Body
application/json
application/json
application/json
curl -X PATCH "https://api.aura-app.ai/v1/leads/550e8400-e29b-41d4-a716-446655440000" \ -H "Content-Type: application/json" \ -d '{}'{
"data": {
"company": "Acme Corp",
"created_at": "2026-01-17T08:00:00Z",
"disqualification_data": {
"booking_link_id": "string",
"evaluated_at": "string",
"triggering_field": {
"key": "string",
"label": "string",
"value": null
},
"property1": null,
"property2": null
},
"email": "john@example.com",
"full_name": "John Doe",
"id": "550e8400-e29b-41d4-a716-446655440000",
"last_payment_at": "string",
"metadata": {
"city": "string",
"country": "string",
"countryCode": "US",
"dataConsentAcceptedAt": "2026-05-08T14:23:11.000Z",
"dclid": "string",
"epik": "string",
"fbclid": "string",
"gadSource": "string",
"gbraid": "string",
"gclid": "string",
"gclsrc": "string",
"hyclid": "string",
"ipAddress": "string",
"language": "en-US",
"latitude": 0,
"liFatId": "string",
"longitude": 0,
"msclkid": "string",
"partner": "string",
"rdtCid": "string",
"ref": "string",
"referrer": "https://acme.com/book-a-call",
"region": "string",
"scCid": "string",
"screenHeight": 0,
"screenWidth": 0,
"setterCode": "string",
"ttclid": "string",
"twclid": "string",
"userAgent": "string",
"utmCampaign": "spring-2026",
"utmContent": "string",
"utmId": "string",
"utmMedium": "cpc",
"utmSource": "google",
"utmTerm": "string",
"wbraid": "string",
"yclid": "string",
"property1": null,
"property2": null
},
"notes": [
{
"content": "string",
"created_at": "2026-05-08T14:23:11.000Z",
"user_id": "string",
"property1": null,
"property2": null
}
],
"payment_count": 0,
"payment_status": "string",
"phone": "+14155552671",
"source": {
"referrer": "https://acme.com/book-a-call",
"utm_campaign": "summer_promo",
"utm_content": "string",
"utm_medium": "cpc",
"utm_source": "google",
"utm_term": "string"
},
"status": "new",
"timezone": "America/New_York",
"total_paid_cents": 0,
"updated_at": "2026-01-17T09:30:00Z"
},
"success": true
}{
"code": "NOT_FOUND",
"error": "Lead not found",
"requestId": "req_abc123",
"success": false
}{
"code": "NOT_FOUND",
"error": "Lead not found",
"requestId": "req_abc123",
"success": false
}