---
title: "Create a New Realm"
method: POST
path: "/v1/tenants/{tenant_id}/realms"
tags: ["Realms"]
---

# Create a New Realm

`POST /v1/tenants/{tenant_id}/realms`

## Request

- Base URL: `https://api-us.beyondidentity.com`
- URL: `https://api-us.beyondidentity.com/v1/tenants/{tenant_id}/realms`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/beyondidentity/apis/beyond-identity-secure-access-api/docs/v1/tenants/:tenant_id/realms/post.ts> (a function with typed inputs; its response is checked against the schema)

To create a realm, send a POST request to `/v1/tenants/$TENANT_ID/realms`. Values in the request body for read-only fields will be ignored.

## Path parameters

- `tenant_id` string, required

## Request body

- object: Request for CreateRealm.
  - `realm` Realm, required: A realm is a unique administrative domain within a tenant. Realms may be used to define multiple development environments or for isolated administrative domains.
    - `id` string: A unique identifier for the realm. This is automatically generated on creation. This field is immutable and read-only. This field is unique within the tenant.
    - `tenant_id` string: A unique identifier of the realm's tenant. This is automatically set on creation. This field is immutable and read-only.
    - `display_name` string: A human-readable name for the realm. This name is used for display purposes.
    - `classification` string: Classification of the realm. Can be either SECURE_WORFORCE or SECURE_CUSTOMER
    - `create_time` string, date-time: A time value given in ISO8601 combined date and time format that represents when the realm was created. This is automatically generated on creation. This field is read-only.
    - `update_time` string, date-time: A time value given in ISO8601 combined date and time format that represents when the realm was last updated. This is automatically updated when the realm is updated. This field is read-only.

## Response `200`

The response will be a JSON object containing the standard attributes associated with a realm.

- Realm: A realm is a unique administrative domain within a tenant. Realms may be used to define multiple development environments or for isolated administrative domains.
  - `id` string: A unique identifier for the realm. This is automatically generated on creation. This field is immutable and read-only. This field is unique within the tenant.
  - `tenant_id` string: A unique identifier of the realm's tenant. This is automatically set on creation. This field is immutable and read-only.
  - `display_name` string: A human-readable name for the realm. This name is used for display purposes.
  - `classification` string: Classification of the realm. Can be either SECURE_WORFORCE or SECURE_CUSTOMER
  - `create_time` string, date-time: A time value given in ISO8601 combined date and time format that represents when the realm was created. This is automatically generated on creation. This field is read-only.
  - `update_time` string, date-time: A time value given in ISO8601 combined date and time format that represents when the realm was last updated. This is automatically updated when the realm is updated. This field is read-only.

## Other responses

- `400`: Bad request.
- `401`: Unauthorized.
- `403`: Forbidden.
- `500`: Server error.

---

[API](https://skmtc.dev/beyondidentity/apis/beyond-identity-secure-access-api.md) - [All operations](https://skmtc.dev/beyondidentity/apis/beyond-identity-secure-access-api/llms.txt) - [OpenAPI document](https://skmtc.dev/beyondidentity/apis/beyond-identity-secure-access-api/revisions/42f3cac49392?raw)