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.
emailstring
Email address (required)
Format
emailfull_name?string
Full name of the lead
phone?string
Phone number in E.164 format
company?string
Company name
timezone?string
Lead's timezone (IANA format)
metadata?unknown
Additional metadata (JSONB)
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" }'{
"success": true,
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"full_name": "John Doe",
"email": "john@example.com",
"phone": "+14155552671",
"company": "Acme Corp",
"status": "new",
"notes": null,
"metadata": null,
"source": {
"utm_source": "google",
"utm_medium": "cpc",
"utm_campaign": "summer_promo",
"utm_term": "string",
"utm_content": "string",
"referrer": "https://acme.com/book-a-call"
},
"timezone": "America/New_York",
"disqualification_data": null,
"payment_status": "string",
"payment_count": 0,
"total_paid_cents": 0,
"last_payment_at": "string",
"created_at": "2026-01-17T08:00:00Z",
"updated_at": "2026-01-17T09:30:00Z"
}
}{
"success": false,
"error": "Lead not found",
"code": "NOT_FOUND",
"requestId": "req_abc123"
}{
"success": false,
"error": "Lead not found",
"code": "NOT_FOUND",
"requestId": "req_abc123"
}