---
title: "Authorization"
method: POST
path: "/v1/auth/authorization"
tags: ["auth"]
---

# Authorization

`POST /v1/auth/authorization`

## Request

- Base URL: `https://api.mentium.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mentium.io/v1/auth/authorization`
- Auth: none declared

## Request body

- AuthorizationRequest
  - `provider` 'GOOGLE' | 'MICROSOFT' | 'GENERIC_INTEGRATION', required
  - `callback_url` string, nullable

## Response `200`

Successful Response

- AuthorizationState
  - `type` 'AUTH' | 'INBOX_CONNECT', required
  - `redirect_uri` string, nullable
  - `state_token` string, nullable
  - `nonce` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/mentium/apis/mentium-api.md) - [All operations](https://skmtc.dev/mentium/apis/mentium-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mentium/apis/mentium-api/revisions/b4ed8e59432e?raw)