Skip to main content
POST
/
v2
/
api
/
crm
/
people
Create person
curl --request POST \
  --url https://api.withallo.com/v2/api/crm/people \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "John",
  "last_name": "Doe",
  "job_title": "CEO",
  "website": "https://example.com",
  "address": "123 Main St",
  "numbers": [
    "+33612345678"
  ],
  "emails": [
    "[email protected]"
  ],
  "company_id": "com-xyz789"
}
'
{
  "data": {
    "id": "per-abc123",
    "name": "John",
    "last_name": "Doe",
    "job_title": "CEO",
    "website": "https://example.com",
    "address": "123 Main St",
    "numbers": [
      "+33612345678"
    ],
    "emails": [
      "[email protected]"
    ],
    "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"
  }
}

Documentation Index

Fetch the complete documentation index at: https://help.withallo.com/llms.txt

Use this file to discover all available pages before exploring further.

Required scope: CRM_WRITE

​
Body fields

FieldTypeRequiredDefaultDescription
namestringnoFirst name
last_namestringnoLast name
job_titlestringnoJob title
websitestringnoWebsite URL
addressstringnoAddress
numbersarraynoPhone numbers in E.164 format
emailsarraynoEmail addresses
company_idstringnoAssociated company ID
allow_duplicate_numberbooleannofalseAllow creating the person even if one or more phone numbers are already assigned to another person
At least one of name or last_name is required.

​
Associations

Pass a company_id to link the person to an existing company. The company must exist or the request returns an error.

​
Duplicate phone numbers

By default, creating a person with phone numbers that already belong to another person in your team returns a 409 Conflict error. The error response includes the IDs of the existing people so you can update them instead. To create the person anyway, set allow_duplicate_number to true. 
{
  "name": "John",
  "numbers": ["+33612345678"],
  "allow_duplicate_number": true
}
To find the existing person by phone number, use Search people with the phone_number filter.

Authorizations

​
Authorization
string
header
required

Body

application/json

Request body for creating a person

​
numbers
string[]
required

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

Minimum array length: 1
Example:
["+33612345678"]
​
name
string | null

First name

Example:

"John"

​
last_name
string | null

Last name

Example:

"Doe"

​
job_title
string | null

Job title

Example:

"CEO"

​
website
string | null

Website URL

Example:

"https://example.com"

​
address
string | null

Postal address

Example:

"123 Main St"

​
emails
string[] | null

Email addresses

Example:
["[email protected]"]
​
company_id
string | null

ID of the company to associate with

Example:

"com-xyz789"

​
allow_duplicate_number
boolean
default:false

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

Response

Person created

​
data
object

A person in the CRM