> ## Documentation Index
> Fetch the complete documentation index at: https://docs.attio.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Companies

> An object to represent businesses: customers, partners, peers...

```yaml Company configuration theme={"system"}
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](/rest-api/attribute-types/attribute-types-domain)                     | Unique, multiselect                                                                                                                          |
| Name                  | `name`                  | [Text](/rest-api/attribute-types/attribute-types-text)                         |                                                                                                                                              |
| Description           | `description`           | [Text](/rest-api/attribute-types/attribute-types-text)                         |                                                                                                                                              |
| Team                  | `team`                  | [Record reference](/rest-api/attribute-types/attribute-types-record-reference) | Relationship, inverse of `Person -> company`, multiselect                                                                                    |
| Categories            | `categories`            | [Select](/rest-api/attribute-types/attribute-types-select)                     | Multiselect                                                                                                                                  |
| Primary location      | `primary_location`      | [Location](/rest-api/attribute-types/attribute-types-location)                 |                                                                                                                                              |
| AngelList             | `angellist`             | [Text](/rest-api/attribute-types/attribute-types-text)                         |                                                                                                                                              |
| Facebook              | `facebook`              | [Text](/rest-api/attribute-types/attribute-types-text)                         |                                                                                                                                              |
| Instagram             | `instagram`             | [Text](/rest-api/attribute-types/attribute-types-text)                         |                                                                                                                                              |
| LinkedIn              | `linkedin`              | [Text](/rest-api/attribute-types/attribute-types-text)                         |                                                                                                                                              |
| Twitter               | `twitter`               | [Text](/rest-api/attribute-types/attribute-types-text)                         |                                                                                                                                              |
| Associated deals      | `associated_deals`      | [Record reference](/rest-api/attribute-types/attribute-types-record-reference) | Relationship, inverse of `Deal -> associated_companies` (only visible if [Deals](/docs/standard-objects/standard-objects-deals) activated    |
| Associated workspaces | `associated_workspaces` | [Record reference](/rest-api/attribute-types/attribute-types-record-reference) | Relationship, inverse of `Workspace -> company` (only visible if [Workspaces](/docs/standard-objects/standard-objects-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.