Skip to main content
POST
/
leads
/
create
cURL
curl --request POST \
  --url https://api.attent.app/v1/leads/create \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "firstName": "John",
  "lastName": "Doe",
  "phone": "+15555555555",
  "customerProfile": "My Customer Profile",
  "timeZone": "America/New_York",
  "email": "example@gmail.com",
  "outboundPhone": "+15551234567",
  "scheduledImportAt": "2027-12-15T18:30:00Z",
  "additionalInfo": {
    "key1": "value1",
    "key2": "value2"
  }
}
'
{
  "message": "Lead created successfully."
}

Authorizations

​
x-api-key
string
header
required

Body

application/json

Lead to create. Phone number must be unique.

​
firstName
string
required

The first name of the lead.

​
lastName
string
required

The last name of the lead.

​
phone
string
required

The phone number must begin with an area code (+) and can contain digits, spaces, parentheses, and hyphens (e.g. +1 (555) 555-5555)

​
customerProfile
string
required

The name of the customer profile to which this lead should belong to.

​
timeZone
string

The timezone of the lead in tz database format (e.g. America/New_York, Europe/London).

​
email
string

The email address of the lead. Must be a valid email format (e.g. user@domain.com).

​
outboundPhone
string

The phone number to use for outbound texts and calls to this lead. Must be a phone number configured for your organization. If not specified, the organization default phone number will be used.

​
additionalInfo
object

An optional key-value object containing additional information to store with the lead.

​
scheduledImportAt
string<date-time>

Optional. If set, the lead is imported now but the first outbound message is deferred until this time. Must be an ISO 8601 timestamp with seconds and an explicit timezone offset (e.g. 2027-12-15T18:30:00Z or 2027-12-15T13:30:00-05:00), must be strictly in the future, and must be no more than 365 days from now. When this is provided, it overrides your organization's business-hours, allowed-days, and holiday adjustments.

Example:

"2027-12-15T18:30:00Z"

Response

A lead has been successfully created.

​
message
string

Returns "Lead created successfully." if the lead was created successfully.

​
id
string

The ID of the lead that was created.