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

# The User Identity Object

> Learn how the user_identity object links a person to their application user account so you can manage their mobile credentials and access in Seam.

## The user\_identity Object

Represents a [user identity](https://docs.seam.co/capability-guides/mobile-access/managing-mobile-app-user-accounts-with-user-identities#what-is-a-user-identity) associated with an application user account.

<ResponseExample>
  ```json User Identity theme={null}
  {
    "created_at": "2025-06-16T16:54:17.946546Z",
    "display_name": "Jane Doe",
    "email_address": "jane@example.com",
    "errors": [],
    "full_name": "Jane Doe",
    "phone_number": "+1555551002",
    "user_identity_id": "43947360-cdc8-4db6-8b22-e079416d1d8b",
    "user_identity_key": "jane_doe",
    "acs_user_ids": [
      "0fc82df4-391b-4d00-a234-86378f1c3952"
    ],
    "warnings": [],
    "workspace_id": "b7e0a4e0-1044-4319-9a0b-42b642b68c7f"
  }
  ```
</ResponseExample>

***

## Properties

<ResponseField name="acs_user_ids" type="Array">
  Array of access system user IDs associated with the user identity.
</ResponseField>

<ResponseField name="created_at" type="String (ISO 8601)">
  Date and time at which the user identity was created.
</ResponseField>

<ResponseField name="display_name" type="String">
  The display name.
</ResponseField>

<ResponseField name="email_address" type="String">
  Unique email address for the user identity.
</ResponseField>

<ResponseField name="errors" type="Array">
  Array of errors associated with the user identity. Each error object within the array contains fields like "error\_code" and "message." "error\_code" is a string that uniquely identifies the type of error, enabling quick recognition and categorization of the issue. "message" provides a more detailed description of the error, offering insights into the issue and potentially how to rectify it.
</ResponseField>

<ResponseField name="full_name" type="String">
  The full name.
</ResponseField>

<ResponseField name="phone_number" type="String">
  Unique phone number for the user identity in [E.164 format](https://www.itu.int/rec/T-REC-E.164/en) (for example, +15555550100).
</ResponseField>

<ResponseField name="user_identity_id" type="String (UUID)">
  ID of the user identity.
</ResponseField>

<ResponseField name="user_identity_key" type="String">
  Unique key for the user identity.
</ResponseField>

<ResponseField name="warnings" type="Array">
  Array of warnings associated with the user identity. Each warning object within the array contains two fields: "warning\_code" and "message." "warning\_code" is a string that uniquely identifies the type of warning, enabling quick recognition and categorization of the issue. "message" provides a more detailed description of the warning, offering insights into the issue and potentially how to rectify it.
</ResponseField>

<ResponseField name="workspace_id" type="String (UUID)">
  ID of the [workspace](https://docs.seam.co/core-concepts/workspaces) that contains the user identity.
</ResponseField>