> ## 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.

# Overview

> Manage people, companies, and deals in your Allo CRM

The CRM API lets you create, read, update, and search people and companies, and read deals synced from your CRM integrations.

## Scopes

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

Records cannot be deleted through the API. Deals are read-only: they are synced from your CRM integrations and cannot be created or updated here.

## What you can do

| Entity    | Get | Search | Create | Update |
| --------- | --- | ------ | ------ | ------ |
| People    | yes | yes    | yes    | yes    |
| Companies | yes | yes    | yes    | yes    |
| Deals     | yes | yes    | no     | no     |

## Associations

* A person can belong to one company (`company_id`)
* A company can have multiple people and multiple deals linked to it
* A deal can be associated with one company, and linked to a person via integration sync

## Resources

<CardGroup cols={3}>
  <Card title="People" href="/en/v2/api-reference/crm/people-overview">
    Create, read, update, and search contacts
  </Card>

  <Card title="Companies" href="/en/v2/api-reference/crm/companies-overview">
    Create, read, update, and search companies
  </Card>

  <Card title="Deals" href="/en/v2/api-reference/crm/deals-overview">
    Read deals synced from your integrations
  </Card>
</CardGroup>