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 and Update company, and read them back on every company response.