> ## 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.

# Users

> An object to represent users of your product

```yaml User configuration theme={"system"}
api_slug: users
singular_noun: User
plural_noun: Users
```

The User object is available in every Attio workspace, but disabled by default. It can only be activated by a workspace admin, in the [Objects settings](https://app.attio.com/_/settings/data/objects) page.

Users represent a user of your product. They are related to a [Person](/docs/standard-objects/standard-objects-people), have an email address, and an ID attribute that is defined by your system. Users are grouped together in Workspaces.

## Writeable attributes

| Attribute             | Slug                    | Type                                                                       | Traits                                                              |
| --------------------- | ----------------------- | -------------------------------------------------------------------------- | ------------------------------------------------------------------- |
| Person                | `person`                | [Record reference](/docs/attribute-types/attribute-types-record-reference) | Relationship, inverse of `Person -> associated_users`               |
| Primary email address | `primary_email_address` | [Text](/docs/attribute-types/attribute-types-text)                         | Required, unique - this is usually their login email in your system |
| ID                    | `user_id`               | [Text](/docs/attribute-types/attribute-types-text)                         | Required, unique - this is usually their ID in your system          |
| Workspaces            | `workspace`             | [Record reference](/docs/attribute-types/attribute-types-record-reference) | Relationship, inverse of `Workspace -> users`                       |

Users can be asserted by either their `primary_email_address` or `user_id` unique attributes, or you can add your own.