Skip to main content
POST
Add a new person

Authorizations

Authorization
string
header
required

Authenticate with a Bearer token: API key, OAuth token, or session token.

Body

application/json
name
string
required

Full name of the person

Minimum string length: 1
linkedin_url
string<uri>
required

LinkedIn profile URL

first_name
string

First name of the person

last_name
string

Last name of the person

current_job_title
string

Current job title

linkedin_location
string

LinkedIn location

company_name
string

Current company name

emails
string<email>[]

Additional email addresses as an array

work_email
string<email>

Work email address

work_phone
string

Work phone number

personal_email
string<email>

Personal email address

mobile_phone
string

Mobile phone number

phone_numbers
string[]

Additional phone numbers as an array

notes
string

Initial notes about the person

job_id
string

Job ID for candidate association

job_name
string

Job name for candidate association

client_name
string

Client company name

client_id
string

Explicit client company ID if known

external_source_id
string

External source ID for the person (e.g. Hubspot, External system, etc.)

enrich_record
boolean

Whether to enrich the person record

Response

Successful response

error
string | null
required

Error message, if any

data
object
required