Creer une personne

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"
}
'

import requests

url = "https://api.withallo.com/v2/api/crm/people"

payload = {
    "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"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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'
  })
};

fetch('https://api.withallo.com/v2/api/crm/people', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.withallo.com/v2/api/crm/people",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    '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'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.withallo.com/v2/api/crm/people"

	payload := strings.NewReader("{\n  \"name\": \"John\",\n  \"last_name\": \"Doe\",\n  \"job_title\": \"CEO\",\n  \"website\": \"https://example.com\",\n  \"address\": \"123 Main St\",\n  \"numbers\": [\n    \"+33612345678\"\n  ],\n  \"emails\": [\n    \"[email protected]\"\n  ],\n  \"company_id\": \"com-xyz789\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.withallo.com/v2/api/crm/people")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"John\",\n  \"last_name\": \"Doe\",\n  \"job_title\": \"CEO\",\n  \"website\": \"https://example.com\",\n  \"address\": \"123 Main St\",\n  \"numbers\": [\n    \"+33612345678\"\n  ],\n  \"emails\": [\n    \"[email protected]\"\n  ],\n  \"company_id\": \"com-xyz789\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.withallo.com/v2/api/crm/people")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"John\",\n  \"last_name\": \"Doe\",\n  \"job_title\": \"CEO\",\n  \"website\": \"https://example.com\",\n  \"address\": \"123 Main St\",\n  \"numbers\": [\n    \"+33612345678\"\n  ],\n  \"emails\": [\n    \"[email protected]\"\n  ],\n  \"company_id\": \"com-xyz789\"\n}"

response = http.request(request)
puts response.read_body

{
  "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"
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "request_id": "<string>",
    "retry_after_seconds": 123
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "request_id": "<string>",
    "retry_after_seconds": 123
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "request_id": "<string>",
    "retry_after_seconds": 123
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "request_id": "<string>",
    "retry_after_seconds": 123
  }
}

POST

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"
}
'

import requests

url = "https://api.withallo.com/v2/api/crm/people"

payload = {
    "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"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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'
  })
};

fetch('https://api.withallo.com/v2/api/crm/people', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.withallo.com/v2/api/crm/people",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    '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'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.withallo.com/v2/api/crm/people"

	payload := strings.NewReader("{\n  \"name\": \"John\",\n  \"last_name\": \"Doe\",\n  \"job_title\": \"CEO\",\n  \"website\": \"https://example.com\",\n  \"address\": \"123 Main St\",\n  \"numbers\": [\n    \"+33612345678\"\n  ],\n  \"emails\": [\n    \"[email protected]\"\n  ],\n  \"company_id\": \"com-xyz789\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.withallo.com/v2/api/crm/people")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"John\",\n  \"last_name\": \"Doe\",\n  \"job_title\": \"CEO\",\n  \"website\": \"https://example.com\",\n  \"address\": \"123 Main St\",\n  \"numbers\": [\n    \"+33612345678\"\n  ],\n  \"emails\": [\n    \"[email protected]\"\n  ],\n  \"company_id\": \"com-xyz789\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.withallo.com/v2/api/crm/people")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"John\",\n  \"last_name\": \"Doe\",\n  \"job_title\": \"CEO\",\n  \"website\": \"https://example.com\",\n  \"address\": \"123 Main St\",\n  \"numbers\": [\n    \"+33612345678\"\n  ],\n  \"emails\": [\n    \"[email protected]\"\n  ],\n  \"company_id\": \"com-xyz789\"\n}"

response = http.request(request)
puts response.read_body

{
  "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"
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "request_id": "<string>",
    "retry_after_seconds": 123
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "request_id": "<string>",
    "retry_after_seconds": 123
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "request_id": "<string>",
    "retry_after_seconds": 123
  }
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "retryable": true,
    "request_id": "<string>",
    "retry_after_seconds": 123
  }
}

Scope requis : CRM_WRITE

Champs du body

Champ	Type	Requis	Defaut	Description
`name`	string	non		Prenom
`last_name`	string	non		Nom de famille
`job_title`	string	non		Poste
`website`	string	non		URL du site web
`address`	string	non		Adresse
`numbers`	array	non		Numeros de telephone au format E.164
`emails`	array	non		Adresses email
`company_id`	string	non		ID de l’entreprise associee
`allow_duplicate_number`	boolean	non	`false`	Autorise 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

Show child attributes

Obtenir une personne Mettre a jour une personne

API

Webhooks

Conversations

Personnes

Entreprises

Deals

Numéros de téléphone

Tags

Modèles de résumé

Utilisateurs

SMS

Analytiques

Power Dialer

Partner

Champs du body

Associations

Numeros de telephone en double

Autorisations

Corps

Réponse

​Champs du body

​Associations

​Numeros de telephone en double

Autorisations

Corps

Réponse

Champs du body

Associations

Numeros de telephone en double