Companies

Company configuration

api_slug: companies
singular_noun: Company
plural_noun: Companies

The company object is available in every Attio workspace. Companies represent businesses, such as customers, partners, suppliers, etc. When creating a person, a related company record will automatically be generated or matched based on the domain of the person’s email address, but they can also be created manually via the web application or the API. Company records are enriched, which means that Attio will automatically populate additional attributes, and those enriched values cannot be overridden by API users. Additionally, some enriched attributes may be hidden from the API depending on the workspace billing plan.

Writable attributes

The following attributes can always be read and written using the API:

Attribute	Slug	Type	Traits
Domains	`domains`	Domain	Unique, multiselect
Name	`name`	Text
Description	`description`	Text
Team	`team`	Record reference	Relationship, inverse of `Person -> company`, multiselect
Categories	`categories`	Select	Multiselect
Primary location	`primary_location`	Location
AngelList	`angellist`	Text
Facebook	`facebook`	Text
Instagram	`instagram`	Text
LinkedIn	`linkedin`	Text
Twitter	`twitter`	Text
Associated deals	`associated_deals`	Record reference	Relationship, inverse of `Deal -> associated_companies` (only visible if Deals activated
Associated workspaces	`associated_workspaces`	Record reference	Relationship, inverse of `Workspace -> company` (only visible if Workspaces activated)

It’s important to note that while standard attributes like domains have unique properties by default, you cannot create new custom attributes with a unique constraint for Company objects.

Get started

Core concepts

Further reading

Writable attributes

​Writable attributes

Writable attributes