> ## Documentation Index
> Fetch the complete documentation index at: https://plain-docs-orca-916-agent-docs-restructure.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Upserting tenants

> Create or update a tenant, keyed on the external ID it has in your own product.

When upserting a tenant you need to specify an `externalId` which matches the id of the tenant in your own backend.

<Snippet file="graphql/sdk-note.mdx" />

For example if your product is structured in teams, then when creating a tenant for a team you'd use the team's id as the `externalId`.

To upsert a tenant you need the following permissions:

* `tenant:read`
* `tenant:create`

<Snippet file="graphql/upsert-tenant.mdx" />