> ## 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](/rest-api/attribute-types/attribute-types-record-reference) | Relationship, inverse of `Person -> associated_users` |
| Primary email address | `primary_email_address` | [Text](/rest-api/attribute-types/attribute-types-text) | Required, unique - this is usually their login email in your system |
| ID | `user_id` | [Text](/rest-api/attribute-types/attribute-types-text) | Required, unique - this is usually their ID in your system |
| Workspaces | `workspace` | [Record reference](/rest-api/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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.