v1

latestOpenAPI 3.0.32026-07-264955102.7 KB

CRM

Create person

Creates a new person in your CRM.

post/v2/api/crm/people

Request body

namestring nullable

First name

last_namestring nullable

Last name

job_titlestring nullable

Job title

websitestring nullable

Website URL

addressstring nullable

Postal address

numbersstring[] required

Phone numbers in E.164 format. At least one number is required.

emailsstring[] nullable

Email addresses

company_idstring nullable

ID of the company to associate with

allow_duplicate_numberboolean

When true, allows creating a person even if the phone numbers are already assigned to another person. Defaults to false.

Example request

{
  "name": "John",
  "last_name": "Doe",
  "job_title": "CEO",
  "website": "https://example.com",
  "address": "123 Main St",
  "numbers": [
    "+33612345678"
  ],
  "emails": [
    "john@example.com"
  ],
  "company_id": "com-xyz789"
}

Response

Person created

Example response

{
  "data": {
    "id": "per-abc123",
    "name": "John",
    "last_name": "Doe",
    "job_title": "CEO",
    "website": "https://example.com",
    "address": "123 Main St",
    "numbers": [
      "+33612345678"
    ],
    "emails": [
      "john@example.com"
    ],
    "company": {
      "id": "com-xyz789",
      "name": "Acme Corp"
    },
    "interactions": 5,
    "last_activity_at": "2026-04-28T10:30:00",
    "created_at": "2026-04-01T09:00:00",
    "updated_at": "2026-04-28T10:30:00"
  }
}