---
title: "Initiate Oauth"
method: POST
path: "/oauth2-connect/initiate"
tags: ["oauth-connect"]
---

# Initiate Oauth

`POST /oauth2-connect/initiate`

Initiate OAuth flow for any provider

## Request body

- OAuthInitiateRequest
  - `provider` 'google' | 'microsoft' | 'github' | 'slack' | 'twitter', required
  - `scopes` string[], nullable
  - `provider_params` object, nullable
  - `onboarding_config` OnboardingConfig — Configuration for auto-onboarding after OAuth success
    - `start_date` string, nullable
    - `include_labels` string[], nullable
    - `include_domains` string[], nullable
  - `auto_execute` boolean
  - `is_initial_onboarding` boolean

## Response `200`

Successful Response

- OAuthResponse
  - `authorization_url` string, required
  - `oauth_state` string, required
  - `provider` string, required

## Other responses

- `422` — Validation Error

---

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