OpenapiV1Leads
Create lead
Create a new lead in your organization.
Use Cases:
- Partner systems creating leads from external sources
- CRM integrations syncing leads into Aura
- Manual lead entry from external applications
Required fields:
email- Must be a valid email address
Optional fields:
full_name,phone,company,timezone,metadata
New leads are created with status "new" by default.
company?string
Company name
emailstring
Email address (required)
Format
emailfull_name?string
Full name of the lead
metadata?
Lead attribution metadata. See the LeadMetadata schema for documented camelCase keys (utmSource, fbclid, etc.). Unknown keys are accepted for forward compatibility but only the documented fields are part of the stable contract. 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}$timezone?string
Lead's timezone (IANA format)
Response Body
application/json
application/json
application/json
curl -X POST "https://api.aura-app.ai/v1/leads" \ -H "Content-Type: application/json" \ -d '{ "email": "john@example.com" }'{
"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
}