Skip to main content
POST
/
v1
/
inbound
/
contacts
Create Contact
curl --request POST \
  --url https://enrich.octolane.com/v1/inbound/contacts \
  --header 'Content-Type: <content-type>' \
  --header 'X-API-Key: <x-api-key>' \
  --data '
{
  "email": "<string>",
  "first_name": "<string>",
  "last_name": "<string>"
}
'
{
  "success": true,
  "data": {
    "people_id": "<string>",
    "email": "<string>",
    "first_name": "<string>",
    "last_name": "<string>"
  },
  "message": "<string>"
}
Creates a person record by email. If the contact already exists, returns the existing record. Octolane also auto-creates the associated company account from the email domain.
You usually don’t need to call this directly. When you create an opportunity with a primary_contact_email, the contact is created automatically.

​
Request

​
X-API-Key
string
required
Your Octolane API key.
​
Content-Type
string
required
Must be application/json.

​
Body parameters

​
email
string
required
Contact’s email address. This is how Octolane identifies and deduplicates contacts.
​
first_name
string
Contact’s first name.
​
last_name
string
Contact’s last name.

​
Example request

curl -X POST "https://enrich.octolane.com/v1/inbound/contacts" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "email": "john@acme.com",
    "first_name": "John",
    "last_name": "Doe"
  }'

​
Response

​
success
boolean
Whether the request succeeded.
​
data
object
​
message
string
Human-readable status message.
200
{
  "success": true,
  "data": {
    "people_id": "aa0e8400-e29b-41d4-a716-446655440000",
    "email": "john@acme.com",
    "first_name": "John",
    "last_name": "Doe"
  },
  "message": "Contact created successfully"
}