POST
/
v1
/
leads
Create a Lead
curl --request POST \
  --url https://api.air.ai/v1/leads \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '{
  "firstName": 123,
  "lastName": "<string>",
  "phone": "<string>",
  "email": "<string>",
  "listId": 123,
  "extraFields": "<any>"
}'
{
  "status": "OK"
}

​
Request

​
Authentication

​
Authorization
string
required
Bearer authentication token.
​
firstName
integer
default:"string"
The first name of the lead.
​
lastName
string
default:"string"
The last name of the lead.
​
phone
string
default:"string"
required
The phone number you want to dial.
​
email
string
default:"string"
The email address of the lead.
​
listId
number
default:"1"
required
The id of the contacts list that you want to create a lead in.
​
extraFields
json
default:"{}"
required
Metadata you want to create the lead’s contact object with.

​
Response

200 
{
  "status": "OK"
}

​
Tutorial

Loom Video