---
title: "Initiate Oauth"
method: POST
path: "/api/workflows/{team_key}/credentials/oauth/initiate"
tags: ["workflows"]
---

# Initiate Oauth

`POST /api/workflows/{team_key}/credentials/oauth/initiate`

## Request

- Base URL: `https://api.superit.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.superit.ai/api/workflows/{team_key}/credentials/oauth/initiate`
- Auth: HTTP bearer

Start OAuth registration — returns authorize URL.

## Path parameters

- `team_key` string, required

## Request body

- OAuthInitiateBody
  - `credentialName` string, required
  - `provider` 'azuread-oauth2' | 'microsoft-graph', required
  - `scopes` string[], required
  - `chatKey` string, nullable
  - `credentialKey` string, nullable

## Response `200`

Successful Response

- OAuthInitiateResponse
  - `redirectUrl` string, required
  - `state` string, required

## Other responses

- `400`: Invalid input
- `401`: Not authenticated
- `403`: Forbidden
- `404`: Not found
- `405`: Method not allowed
- `409`: Conflict
- `422`: Validation Error

---

[API](https://skmtc.dev/superit/apis/super-it-api.md) - [All operations](https://skmtc.dev/superit/apis/super-it-api/llms.txt) - [OpenAPI document](https://skmtc.dev/superit/apis/super-it-api/revisions/4944d556c2bb?raw)