---
title: "Create account"
method: POST
path: "/v1/accounts"
tags: ["CRM"]
---

# Create account

`POST /v1/accounts`

## Request

- Base URL: `https://api.octolane.com`
- URL: `https://api.octolane.com/v1/accounts`
- Auth: API key in header `x-api-key`

Creates an account from a domain, or returns the existing account when the domain is already present. Additional account fields are persisted as system or custom attributes when supported.

## Request body

- AccountInput
  - `domain` string, required: Company domain.
  - `name` string, nullable
  - `industry` string, nullable
  - `logo` string, nullable
  - `linkedin` string, nullable
  - `twitter` string, nullable
  - `twitter_followers` number, nullable
  - `description` string, nullable
  - `primary_location` string, nullable
  - `founded` number, nullable
  - `estimated_revenue` number, nullable
  - `total_fund_raised` number, nullable
  - `employee_range` string, nullable
  - `type` string, nullable
  - `tags` union
    - string[]
    - string
  - `first_email_interaction` union
    - string, date-time
    - number: Unix seconds or milliseconds.
  - `last_email_interaction` union
    - string, date-time
    - number: Unix seconds or milliseconds.
  - `first_meeting_interaction` union
    - string, date-time
    - number: Unix seconds or milliseconds.
  - `last_meeting_interaction` union
    - string, date-time
    - number: Unix seconds or milliseconds.
  - `last_interaction` union
    - string, date-time
    - number: Unix seconds or milliseconds.
  - `next_meeting` union
    - string, date-time
    - number: Unix seconds or milliseconds.

## Response `200`

Account was created or resolved.

- ApiResponse
  - `success` boolean
  - `message` string
  - `data` unknown

## Other responses

- `201`: Account was created or resolved.
- `400`: The request failed validation.
- `401`: The API key is missing, invalid, or not allowed to access this route.
- `429`: The route rate limit was exceeded.

## Changes

- **2026-06-16** `9647d7c49947`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/octolane-org/apis/octolane-public-api/changes/v1/accounts/post.md)

---

[API](https://skmtc.dev/octolane-org/apis/octolane-public-api.md) - [All operations](https://skmtc.dev/octolane-org/apis/octolane-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/octolane-org/apis/octolane-public-api/revisions/d248d0a2be5d?raw)