# Overview

> Manage people in your Allo CRM

The People API lets you create, read, update, and search your team's contacts.

## Scopes

| Scope | Access |
|-------|--------|
| `CRM_READ` | Get and search people |
| `CRM_WRITE` | Create and update people |

## Associations

- **Person → Company**: A person can belong to one company (`company_id`)

## Search

People support search via `POST /v2/api/crm/people/search` with named filters and full-text search.

Available filters: `name`, `last_name`, `job_title`, `website`, `company`, `phone_number`, `email`, `deal_status`.

## Custom attributes

People can carry your own [custom fields](/docs/crm/attributes-overview), such as a lead source or a budget. A custom field is the definition. `custom_attributes` holds the values: set them with `custom_attributes` on [Create person](/docs/crm/create-person) and [Update person](/docs/crm/update-person), and read them back on every person response.

## Endpoints

<CardGroup cols={1}>
  <Card title="Get person" href="/docs/crm/get-person">Get a person by ID</Card>
  <Card title="Create person" href="/docs/crm/create-person">Create a new person</Card>
  <Card title="Update person" href="/docs/crm/update-person">Update a person</Card>
  <Card title="Search people" href="/docs/crm/search-people">Search people with filters</Card>
</CardGroup>
