---
title: "Create person"
method: POST
path: "/v2/api/crm/people"
tags: ["CRM"]
---

# Create person

`POST /v2/api/crm/people`

Creates a new person in your CRM.

## Request body

- CreatePersonRequest — Request body for creating a person
  - `name` string, nullable — First name
  - `last_name` string, nullable — Last name
  - `job_title` string, nullable — Job title
  - `website` string, nullable — Website URL
  - `address` string, nullable — Postal address
  - `numbers` string[], required — Phone numbers in E.164 format. At least one number is required.
  - `emails` string[], nullable — Email addresses
  - `company_id` string, nullable — ID of the company to associate with
  - `allow_duplicate_number` boolean — When true, allows creating a person even if the phone numbers are already assigned to another person. Defaults to false.

## Response `200`

Person created

- object
  - `data` CrmPerson — A person in the CRM
    - `id` string — Unique person identifier
    - `name` string, nullable — First name
    - `last_name` string, nullable — Last name
    - `job_title` string, nullable — Job title
    - `website` string, nullable — Website URL
    - `address` string, nullable — Postal address
    - `numbers` string[] — Phone numbers in E.164 format
    - `emails` string[] — Email addresses
    - `company` CrmCompanyRef, nullable — Embedded company reference
      - `id` string — Company ID
      - `name` string — Company name
    - `interactions` integer — Total number of interactions (calls + messages)
    - `last_activity_at` string, date-time, nullable — Timestamp of the last activity
    - `created_at` string, date-time — When the person was created
    - `updated_at` string, date-time — When the person was last updated

## Other responses

- `401` — Invalid or missing API key
- `409` — Conflict with existing resource
- `422` — Invalid request parameters
- `429` — Rate limit exceeded

---

[API](https://skmtc.dev/withallo/apis/allo-api.md) · [All operations](https://skmtc.dev/withallo/apis/allo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/withallo/allo-api/revisions/9aab4db82933/schema)