Skip to main content
POST
/
v1
/
accounts
Create account
curl --request POST \
  --url https://api.octolane.com/v1/accounts \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "domain": "acme.com",
  "name": "Acme",
  "industry": "<string>",
  "logo": "<string>",
  "linkedin": "<string>",
  "twitter": "<string>",
  "twitter_followers": 123,
  "description": "<string>",
  "primary_location": "<string>",
  "founded": 5499.5,
  "estimated_revenue": 123,
  "total_fund_raised": 123,
  "employee_range": "<string>",
  "type": "<string>",
  "tags": [
    "<string>"
  ],
  "first_email_interaction": "2023-11-07T05:31:56Z",
  "last_email_interaction": "2023-11-07T05:31:56Z",
  "first_meeting_interaction": "2023-11-07T05:31:56Z",
  "last_meeting_interaction": "2023-11-07T05:31:56Z",
  "last_interaction": "2023-11-07T05:31:56Z",
  "next_meeting": "2023-11-07T05:31:56Z"
}
'
{
  "success": true,
  "message": "<string>",
  "data": "<unknown>"
}
Also use this to look up an account by domain. This endpoint is idempotent — if an account with the given domain already exists, it returns that existing account instead of creating a duplicate. So sending a POST with just a domain is a safe way to resolve or fetch an account by its domain.Need to find accounts by other criteria, or match many at once? Use Search accounts for filtered search.

Authorizations

x-api-key
string
header
required

Public API key for the Octolane organization.

Body

application/json

Account payload.

domain
string
required

Company domain.

Example:

"acme.com"

name
string | null
Example:

"Acme"

industry
string | null
logo
string | null
linkedin
string | null
twitter
string | null
twitter_followers
number | null
description
string | null
primary_location
string | null
founded
number | null
Required range: 1000 <= x <= 9999
estimated_revenue
number | null
total_fund_raised
number | null
employee_range
string | null
type
string | null
tags
first_email_interaction
last_email_interaction
first_meeting_interaction
last_meeting_interaction
last_interaction
next_meeting

Response

Account was created or resolved.

success
boolean
Example:

true

message
string
data
any

Endpoint-specific response payload.