---
title: "POST /api/oauth/start"
method: POST
path: "/api/oauth/start"
tags: ["oauth"]
---

# POST /api/oauth/start

`POST /api/oauth/start`

## Request body

- object
  - `client` string, required
  - `clientOwner` 'org' | 'user', required
  - `owner` 'org' | 'user', required
  - `name` string, required
  - `integration` string, required
  - `template` string, required
  - `identityLabel` string, nullable
  - `newConnection` boolean, nullable
  - `redirectUri` string, nullable

## Response `200`

Success

- union
  - object
    - `status` 'connected', required
    - `connection` object, required
      - `owner` 'org' | 'user', required
      - `name` string, required
      - `integration` string, required
      - `template` string, required
      - `provider` string, required
      - `address` string, required
      - `identityLabel` string, nullable, required
      - `expiresAt` union, required
        - number
        - 'NaN'
        - 'Infinity'
        - '-Infinity'
        - 'Infinity' | '-Infinity' | 'NaN'
      - `oauthClient` string, nullable, required
      - `oauthClientOwner` 'org' | 'user', nullable, required
      - `oauthScope` string, nullable, required
      - `missingOAuthScopes` string[], required
  - object
    - `status` 'redirect', required
    - `authorizationUrl` string, required
    - `state` string, required

## Other responses

- `400` — OAuthStartError
- `500` — InternalError

---

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