Skip to main content
POST
Create a contact

Authorizations

Authorization
string
header
required

API key from Settings > Developer. Format: alva_sk_...

Body

application/json

A contact must include at least a first name, last name, or email address; all other fields are optional. In the interactive playground (the "Test Request" panel) the JSON body is fully editable — type over any value and delete the properties you don't need. Blank fields are ignored, so only the values you provide are sent.

firstName
string
required
lastName
string
required
email
string<email> | null
companyId
string<uuid> | null
title
string | null
phone
string | null
mobile
string | null
linkedin
string | null
twitter
string | null
notes
string | null
department
string | null
seniorityLevel
string | null
additionalEmails
string<email>[]
additionalPhones
string[]
linkedinUrl
string<uri> | null
doNotContact
boolean
doNotContactReason
string | null
customFields
object

Response

Contact

success
boolean
Example:

true

message
string

Human-readable confirmation of the action.

data
object
resource
string