Skip to main content
POST
https://api.stateset.com
/
v1
/
leads
curl --location --request POST 'https://api.stateset.com/v1/leads' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data-raw '{
    "firstName": "Sarah",
    "lastName": "Johnson",
    "email": "[email protected]",
    "phone": "+1-555-234-5678",
    "title": "VP of Operations",
    "department": "Operations",
    "leadSource": "website",
    "description": "Interested in returns automation"
}'

{
  "id": "e0901f08-3aa1-43c5-af5c-0a9d2fc64e30",
  "object": "lead",
  "firstName": "Sarah",
  "lastName": "Johnson",
  "email": "[email protected]",
  "phone": "+1-555-234-5678",
  "title": "VP of Operations",
  "department": "Operations",
  "leadSource": "website",
  "status": "new",
  "description": "Interested in returns automation",
  "created_at": "2024-06-15T10:30:00.000Z"
}
Creates a lead that can be tracked, engaged, and converted into a customer or account.

​
Request Body

​
firstName
string
required
First name of the lead.Example: Sarah
​
lastName
string
required
Last name of the lead.Example: Johnson
​
email
string
required
Email address of the lead. Must be unique.Example: [email protected]
​
phone
string
Phone number of the lead.Example: +1-555-234-5678
​
title
string
Job title or position.Example: VP of Operations
​
department
string
Department or division.Example: Operations
​
leadSource
string
Source or origin of the lead.Options: website, referral, trade_show, cold_call, social_media, partner, other
​
description
string
Additional details or notes about the lead.
​
mailingStreet
string
Street address.
​
mailingCity
string
City.
​
mailingState
string
State or province.
​
mailingCountry
string
Country.
​
do_not_call
boolean
default:"false"
Whether the lead should not be contacted by phone.
​
email_opt_out
boolean
default:"false"
Whether the lead has opted out of email communication.

​
Response

​
id
string
Unique identifier for the created lead.
​
object
string
Object type. Always lead.
​
firstName
string
First name of the lead.
​
lastName
string
Last name of the lead.
​
email
string
Email address of the lead.
​
phone
string
Phone number of the lead.
​
title
string
Job title of the lead.
​
leadSource
string
Source of the lead.
​
status
string
Current status of the lead. Starts as new.
​
created_at
datetime
ISO 8601 timestamp when the lead was created.
curl --location --request POST 'https://api.stateset.com/v1/leads' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <token>' \
--data-raw '{
    "firstName": "Sarah",
    "lastName": "Johnson",
    "email": "[email protected]",
    "phone": "+1-555-234-5678",
    "title": "VP of Operations",
    "department": "Operations",
    "leadSource": "website",
    "description": "Interested in returns automation"
}'

{
  "id": "e0901f08-3aa1-43c5-af5c-0a9d2fc64e30",
  "object": "lead",
  "firstName": "Sarah",
  "lastName": "Johnson",
  "email": "[email protected]",
  "phone": "+1-555-234-5678",
  "title": "VP of Operations",
  "department": "Operations",
  "leadSource": "website",
  "status": "new",
  "description": "Interested in returns automation",
  "created_at": "2024-06-15T10:30:00.000Z"
}