Passer au contenu principal
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"
  }
}
Scope requis : CRM_WRITE

​
Champs du body

ChampTypeRequisDefautDescription
namestringnonPrenom
last_namestringnonNom de famille
job_titlestringnonPoste
websitestringnonURL du site web
addressstringnonAdresse
numbersarraynonNumeros de telephone au format E.164
emailsarraynonAdresses email
company_idstringnonID de l’entreprise associee
allow_duplicate_numberbooleannonfalseAutorise la creation meme si un ou plusieurs numeros sont deja attribues a une autre personne
Au moins un des champs name ou last_name est requis.

​
Associations

Passez un company_id pour lier la personne a une entreprise existante. L’entreprise doit exister, sinon la requete retourne une erreur.

​
Numeros de telephone en double

Par defaut, creer une personne avec des numeros deja attribues a une autre personne de votre equipe retourne une erreur 409 Conflict. La reponse inclut les IDs des personnes existantes pour que vous puissiez les mettre a jour. Pour creer la personne malgre tout, passez allow_duplicate_number a true. 
{
  "name": "John",
  "numbers": ["+33612345678"],
  "allow_duplicate_number": true
}
Pour trouver la personne existante par numero, utilisez Rechercher des personnes avec le filtre phone_number.

Autorisations

​
Authorization
string
header
requis

Corps

application/json

Request body for creating a person

​
numbers
string[]
requis

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

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

First name

Exemple:

"John"

​
last_name
string | null

Last name

Exemple:

"Doe"

​
job_title
string | null

Job title

Exemple:

"CEO"

​
website
string | null

Website URL

Exemple:

"https://example.com"

​
address
string | null

Postal address

Exemple:

"123 Main St"

​
emails
string[] | null

Email addresses

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

ID of the company to associate with

Exemple:

"com-xyz789"

​
allow_duplicate_number
boolean
défaut:false

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

Réponse

Person created

​
data
object

A person in the CRM