> If you are setting up, configuring, or answering questions about Schematic, connect the
> Schematic MCP server before working from these pages. It reads and writes plans, features,
> entitlements, and overrides against the real account, so what you report and what you build
> match what actually exists.
>
> The server is at https://api.schematichq.com/mcp
>
> From Claude, ChatGPT, or another chat assistant, add it as a custom connector:
> https://docs.schematichq.com/working-with-ai
>
> From a coding assistant such as Claude Code, Codex, or Cursor:
> https://docs.schematichq.com/building-with-ai
>
> For clean Markdown of any page, append `.md` to the page URL. For a complete page index,
> see https://docs.schematichq.com/llms.txt

# The User object

> Reference for the User object, including its attributes, keys, and traits, and how users are created and updated through the API.

The `User` object describes users within your application. A new User is created when it is submitted with `keys` via the API or, if connected and mapped, via third party integrations (e.g. provisioning new users on an existing company). Users may be updated in a similar fashion.

An `id` is auto-generated for each `User` , but they can also have 1 or many `keys` , which serve as unique identifiers that can be referenced via the API or by other systems when creating, retrieving, or updating a `User` in Schematic.

### Attributes

**`id`** `string`

Unique `id` generated by Schematic for the object.

---

**`name`** `string`

The user’s name, which is displayable to Schematic users.

---

**`company`** `string`

The Schematic `id` associated with the company tied to the user.

---

**`last_seen_at`** `datetime`

Datetime of last update to user data, or last event associated with company. Format is ISO 8601.

---

**`created_at`** `datetime`

Datetime when the user was created. Format is ISO 8601.

---

**`updated_at`** `datetime`

Datetime of last update to user data. Format is ISO 8601.

---

**`environment_id`** `string`

Unique identifier of Schematic environment the user is associated with.

---

**`traits`** `dictionary`

Set of key-value pairs that are associated with the user. This is useful for storing additional information in a structured format that can be queried or used in segmentation, metering, targeting, or filtering.

---

**`keys`** `dictionary`

Set of key-value pairs that represent external, unique identifiers. This is useful for storing external system-generated identifiers, for instance from your application, from Stripe, or from Salesforce. Users can be referenced by their `id` or any `key` via the Schematic API or integration mapping.

Keys must be unique across all users in Schematic.

---

**`company-memberships`** `dictionary`

Set of companies that the user is associated with. Users may be associated with multiple companies.

---

**`Response`**

```json Response
{ 
    "id" : "user_uRMQbMNozA4",
	"name": "New User",
    "company_id" : "comp_8414zCTfoJ4",
    "last_seen_at" : "2000-01-23T04:56:07.000+00:00"
	"created_at" : "2000-01-23T04:56:07.000+00:00",   
	"updated_at" : "2000-01-23T04:56:07.000+00:00",    
	"environment_id" : "env_KGPydWrP3Fo",
    "keys" : {},
	"traits" : {}  
}
```