> 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 Company object

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

The `Company` object describes companies within your application. A new `Company` is created when it is submitted via the API or, if connected and mapped, via third party integrations (e.g. provisioning a new company after a sale). Companies may be updated in a similar fashion.

An `id` is auto-generated for each `Company` , 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 `Company` in Schematic.

### Attributes

**`id`** `string`

Unique identifier generated by Schematic for the object.

---

**`name`** `string`

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

---

**`lastSeenAt`** `datetime`

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

---

**`createdAt`** `datetime`

Datetime on which the object was created. Format is ISO 8601.

---

**`updatedAt`** `datetime`

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

---

**`environmentId`** `string`

Unique identifier of Schematic environment the Company is associated with.

---

**`traits`** `dictionary`

Set of key-value pairs that are associated with the company. 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. Companies can be referenced by their `id` or any `key` via the Schematic API or integration mapping.

Keys must be unique across all companies in Schematic.

---

**`plans`** `dictionary`

Set of plans for which the company matches the plan audience rule.

---

**`Response`**

```json Response
{
	"id" : "comp_8414zCTfoJ4",	
	"name" : "New Company",
	"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",
	"traits" : {},
	"keys" : {},
	"plans" : {}
}
```