# Vue d'ensemble

> Gerez les personnes dans votre CRM Allo

L'API People vous permet de creer, lire, mettre a jour et rechercher les contacts de votre equipe.

## Scopes

| Scope | Acces |
|-------|-------|
| `CRM_READ` | Obtenir et rechercher des personnes |
| `CRM_WRITE` | Creer et mettre a jour des personnes |

## Associations

- **Person → Company** : Une personne peut appartenir a une entreprise (`company_id`)

## Recherche

Les personnes peuvent etre recherchees via `POST /v2/api/crm/people/search` avec des filtres nommes et une recherche en texte integral.

Filtres disponibles : `name`, `last_name`, `job_title`, `website`, `company`, `phone_number`, `email`, `deal_status`.

## Attributs personnalisés

Les personnes peuvent porter vos propres [champs personnalisés](/fr/docs/crm/attributes-overview), comme une source de lead ou un budget. Un champ personnalisé est la définition. `custom_attributes` contient les valeurs : définissez-les avec `custom_attributes` sur [Créer une personne](/fr/docs/crm/create-person) et [Mettre à jour une personne](/fr/docs/crm/update-person), et relisez-les dans chaque réponse de personne.

## Endpoints

<CardGroup cols={1}>
  <Card title="Obtenir une personne" href="/fr/docs/crm/get-person">Obtenir une personne par ID</Card>
  <Card title="Creer une personne" href="/fr/docs/crm/create-person">Creer une nouvelle personne</Card>
  <Card title="Mettre a jour une personne" href="/fr/docs/crm/update-person">Mettre a jour une personne</Card>
  <Card title="Rechercher des personnes" href="/fr/docs/crm/search-people">Rechercher des personnes avec des filtres</Card>
</CardGroup>
