# UserAccount

## Definition

UserAccount identify a user registered on your different systems, like your CRM, a loyalty program or any authentication system. They have the following properties:

| Property          | Type                 | Description                                              |
| ----------------- | -------------------- | -------------------------------------------------------- |
| user\_account\_id | String               | Usually the same as the ID as the source, like your CRM. |
| compartment\_id   | String               | Compartment associated with the user account             |
| creation\_ts      | Timestamp            | Account's creation timestamp                             |
| expiration\_ts    | Timestamp (optional) | Account's eventual expiration timestamp                  |

Always use the `user_account_id` in correlation with a `compartment_id` to identify a user by its account. If you don't specify a `compartment_id`, then the default compartment will be used.

A **Compartment** is a group that organizes specific user account identifiers. Each compartment has a unique ID that is used to identify the corresponding user account identifier. For instance, “UTIQ Martechpass” might have the compartment id 20.

There are two categories of **Compartments**:

* The **First-party user account compartments** which compartments contain user account identifiers created within your organization, such as CRM identifiers.
* **Shared user account compartments** which include user account identifiers shared from another organisation.

For instance, if you wish to add **UTIQ** to your datamart, first subscribe to it within your community organisation. It will then be automatically shared with your other organisations, but you’ll still need to activate it within your datamart.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.mediarithmics.io/user-points/user-identifiers/useraccount.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.