# Overview

> Manage companies in your Allo CRM

The Companies API lets you create, read, update, and search your team's companies.

## Scopes

| Scope | Access |
|-------|--------|
| `CRM_READ` | Get and search companies |
| `CRM_WRITE` | Create and update companies, and create and update custom attributes |
| `CRM_DELETE` | Delete custom attributes |

## Associations

- **Company → People**: A company can have multiple people associated with it
- **Company → Deals**: A company can have deals linked to it

## Search

Companies support search via `POST /v2/api/crm/companies/search` with named filters.

Available filters: `name`, `website`, `industry`.

## Custom attributes

Custom attributes add your own data to companies, such as a segment or a renewal date. Types: `TEXT`, `NUMBER`, `DATE`, `BOOLEAN` and `DROPDOWN`. Each attribute can carry a `prompt` that tells the AI CRM Manager how to fill it from calls. Attributes synced from a CRM integration are listed too, with their `source`. Only teams on the new contact model can use them.

Attributes are the definitions. `custom_attributes` holds the values: set them with `custom_attributes` on [Create company](/docs/crm/create-company) and [Update company](/docs/crm/update-company), and read them back on every company response.

## Endpoints

<CardGroup cols={1}>
  <Card title="Get company" href="/docs/crm/get-company">Get a company by ID</Card>
  <Card title="Create company" href="/docs/crm/create-company">Create a new company</Card>
  <Card title="Update company" href="/docs/crm/update-company">Update a company</Card>
  <Card title="Search companies" href="/docs/crm/search-companies">Search companies with filters</Card>
  <Card title="List company attributes" href="/docs/crm/list-company-attributes">List custom company attributes</Card>
  <Card title="Create company attribute" href="/docs/crm/create-company-attribute">Create a custom company attribute</Card>
  <Card title="Update company attribute" href="/docs/crm/update-company-attribute">Update a custom company attribute</Card>
  <Card title="Delete company attribute" href="/docs/crm/delete-company-attribute">Delete a custom company attribute</Card>
</CardGroup>
