Skip to main content
POST
Creates a lead that can be tracked, engaged, and converted into a customer or account.

Request Body

string
required
First name of the lead.Example: Sarah
string
required
Last name of the lead.Example: Johnson
string
required
Email address of the lead. Must be unique.Example: sarah.johnson@company.com
string
Phone number of the lead.Example: +1-555-234-5678
string
Job title or position.Example: VP of Operations
string
Department or division.Example: Operations
string
Source or origin of the lead.Options: website, referral, trade_show, cold_call, social_media, partner, other
string
Additional details or notes about the lead.
string
Street address.
string
City.
string
State or province.
string
Country.
boolean
default:"false"
Whether the lead should not be contacted by phone.
boolean
default:"false"
Whether the lead has opted out of email communication.

Response

string
Unique identifier for the created lead.
string
Object type. Always lead.
string
First name of the lead.
string
Last name of the lead.
string
Email address of the lead.
string
Phone number of the lead.
string
Job title of the lead.
string
Source of the lead.
string
Current status of the lead. Starts as new.
datetime
ISO 8601 timestamp when the lead was created.