Skip to main content
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:
AttributeSlugTypeTraits
DomainsdomainsDomainUnique, multiselect
NamenameText
DescriptiondescriptionText
TeamteamRecord referenceRelationship, inverse of Person -> company, multiselect
CategoriescategoriesSelectMultiselect
Primary locationprimary_locationLocation
AngelListangellistText
FacebookfacebookText
InstagraminstagramText
LinkedInlinkedinText
TwittertwitterText
Associated dealsassociated_dealsRecord referenceRelationship, inverse of Deal -> associated_companies (only visible if Deals activated
Associated workspacesassociated_workspacesRecord referenceRelationship, 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.