---
title: "Create a new auth server scope"
method: POST
path: "/v1/auth-servers/{authServerId}/scopes"
tags: ["Auth Server Scopes"]
---

# Create a new auth server scope

`POST /v1/auth-servers/{authServerId}/scopes`

Create a new scope for a given auth server. The `name` attribute must be unique within the auth server.

## Request body

- object
  - `name` string, required — The name of the scope
  - `description` string — Description of the scope
  - `default` boolean — Specifies whether the scope is included by default in access tokens without being explicitly requested by the client. If the scope is not allowed by the client, it will not be included in the access token.
  - `include_in_metadata` boolean — Specifies whether to include the scope in the metadata document
  - `enabled` boolean — Specifies whether the scope is enabled. If the scope is not enabled, it cannot be requested by clients and will not be included in the access token.

## Response `201`

A scope

- Scope
  - `id` string, uuid, required — The ID of the scope
  - `name` string, required — The name of the scope
  - `description` string, required — Description of the scope
  - `default` boolean, required — Specifies whether the scope is included by default in access tokens without being explicitly requested by the client. If the scope is not allowed by the client, it will not be included in the access token.
  - `include_in_metadata` boolean, required — Specifies whether to include the scope in the metadata document
  - `enabled` boolean, required — Specifies whether the scope is enabled. If the scope is not enabled, it cannot be requested by clients and will not be included in the access token.
  - `created_at` string, date-time, required — An ISO-8601 timestamp representation of entity creation date.
  - `updated_at` string, date-time, required — An ISO-8601 timestamp representation of entity update date.

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `409` — Conflict

---

[API](https://skmtc.net/kong/apis/konnect-api.md) · [All operations](https://skmtc.net/kong/apis/konnect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kong/konnect-api/versions/06734a9c491f/schema)