---
title: "Create contact"
method: POST
path: "/v1/contacts"
tags: ["CRM"]
---

# Create contact

`POST /v1/contacts`

Creates a contact from an email address, or returns the existing contact when the email is already present. Optional profile fields are persisted as attributes when supported.

## Request body

- ContactInput
  - `email` string, email, required
  - `first_name` string, nullable
  - `last_name` string, nullable
  - `full_name` string, nullable
  - `job_title` string, nullable
  - `phone` string, nullable
  - `seniority` string, nullable
  - `linkedin` string, nullable
  - `twitter` string, nullable
  - `twitter_followers` number, nullable
  - `current_company` string, nullable
  - `other_emails` union
    - string[]
    - string
  - `type` string, nullable
  - `avatar_url` string, nullable
  - `email_verified` boolean, nullable
  - `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`

Contact was created or resolved.

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

## Other responses

- `201` — Contact 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.

---

[API](https://skmtc.net/octolane-org/apis/octolane-public-api.md) · [All operations](https://skmtc.net/octolane-org/apis/octolane-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/octolane-org/octolane-public-api/versions/8c7700f1eeec/schema)