---
title: "Integrations Oauth2 Callback"
method: POST
path: "/v1/integrations/oauth2/callback"
tags: ["integrations"]
---

# Integrations Oauth2 Callback

`POST /v1/integrations/oauth2/callback`

## 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/integrations/oauth2/callback`
- Auth: none declared

## Query parameters

- `code` string, required

## Request body

- IntegrationAuthorizationState: Serialized OAuth ``state`` for integration connect + callback. ``scope`` controls which fields are written onto ``IntegrationConnection`` (see service). ``connecting_*`` is always the user and workspace active in the UI when Connect was clicked; they are used for Inbox rows (and for deriving connection scope together with ``scope``).
  - `integration_id` string, required
  - `integration_label` string, required
  - `organization_id` string, required
  - `scope` 'ORGANIZATION' | 'WORKSPACE' | 'USER'
  - `connecting_user_id` string, required
  - `connecting_workspace_id` string, required
  - `is_test` boolean, required
  - `name` string, nullable
  - `non_secret_params` object, nullable
  - `redirect_uri` string, nullable
  - `redirect_after` string, nullable
  - `expires_at` integer, nullable
  - `signature` string, nullable

## Response `200`

Successful Response

- unknown

## 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)