# 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, and list custom fields |
| `CRM_WRITE` | Create and update people and companies, and create custom fields |
| `CRM_DELETE` | Delete custom attributes on 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={2}>
  <Card title="People" href="/docs/crm/people-overview">
    Create, read, update, and search contacts
  </Card>
  <Card title="Companies" href="/docs/crm/companies-overview">
    Create, read, update, and search companies
  </Card>
  <Card title="Deals" href="/docs/crm/deals-overview">
    Read deals synced from your integrations
  </Card>
  <Card title="Custom fields" href="/docs/crm/attributes-overview">
    List and create custom fields on people
  </Card>
  <Card title="Views" href="/docs/crm/views-overview">
    List, create, edit and delete saved contact views
  </Card>
</CardGroup>
