---
title: "Create an authorize"
method: POST
path: "/oauth/authorize"
tags: ["API authentication"]
---

# Create an authorize

`POST /oauth/authorize`

## Headers

- `IdempotencyKey` string — A unique key per operation, could be V4 UUID or other high‑entropy random string. Keys can be up to 255 characters. See [Idempotent Requests](/docs/idempotent-requests).

## Request body

- object
  - `response_type` 'code', required
  - `client_id` string, required — Non-empty text string
  - `redirect_uri` string, uri, required — HTTP(S) URL
  - `state` string — Non-empty text string
  - `scope` string[]
  - `code_challenge` string — Non-empty text string
  - `code_challenge_method` 'plain' | 'S256'
  - `prompt` 'none' | 'login' | 'consent' | 'select_account'
  - `audience` string — Non-empty text string
  - `access_type` 'online' | 'offline'
  - `resource` string, uri — HTTP(S) URL

## Response `200`

Successful operation

- object
  - `response_type` 'code', required
  - `client_id` string, required — Non-empty text string
  - `redirect_uri` string, uri, required — HTTP(S) URL
  - `state` string — Non-empty text string
  - `scope` string[]
  - `code_challenge` string — Non-empty text string
  - `code_challenge_method` 'plain' | 'S256'
  - `prompt` 'none' | 'login' | 'consent' | 'select_account'
  - `audience` string — Non-empty text string
  - `access_type` 'online' | 'offline'
  - `resource` string, uri — HTTP(S) URL
  - `id` string, required — An object id with prefix
  - `created_at` string, date-time, required — Creation date and time
  - `created_by` string, required — ID of the user that created this object
  - `updated_at` string, date-time, required — Last update date and time
  - `updated_by` string, required — ID of the user that last updated this object

---

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