Skip to main content
POST
Create Lead

Authorizations

Authorization
string
header
required

Org API key as Token token=ei_live_...

Headers

Idempotency-Key
string | null

Body

application/json

POST /v1/leads — capture an inbound lead into the key's org (e.g. a website quote funnel). name/phone/subject are stored in the lead's free-form payload; email, source_url, notes and a source_form_name snapshot are columns. organization_id, form_id, status and timestamps are server-set, never accepted; status starts 'new'.

name
string
required

Lead's full name.

Minimum string length: 1
email
string
required

Lead's email address (required).

phone
string | null
subject
string | null

Subject of interest, e.g. 'Methods'.

source_form_name
string | null

Where the lead came from, e.g. 'website quote funnel'.

source_url
string | null
notes
string | null

Response

Successful Response

An inbound lead captured by an org lead form. The free-form payload is NOT exposed; only a safe subset (name/email/phone/subject) is flattened.

id
string
required
form_id
string | null
source_form_name
string | null
name
string | null
email
string | null
phone
string | null
subject
string | null
status
string | null
assigned_tutor_id
string | null
source_url
string | null
notes
string | null
converted_at
string | null
created_at
string | null
updated_at
string | null