---
title: "POST Start OAuth flow - returns authorization URL"
description: "Start OAuth flow - returns authorization URL"
last_updated: "2026-05-06T07:33:48.332735+00:00"
canonical_url: "https://www.doc0.dev/docs/49c89830-117b-4def-8edc-b5bcc50766e0/api/integrations/oauthcontroller-startoauth"
---

<APIEndpoint
  method={"POST"}
  path={"/v1/integrations/oauth/start"}
  summary={"Start OAuth flow - returns authorization URL"}
  description={"Start OAuth flow - returns authorization URL"}
  deprecated={false}
  baseUrl={""}
/>

## Request Body

Information to start the OAuth flow.

<APIRequestBody
  contentType={"application/json"}
  required={true}
  schema={{"type":"object"}}
/>

## Responses

<APIResponse
  statusCode={"201"}
  description={"Successfully initiated OAuth flow."}
  contentType={"application/json"}
  schema={{"type":"object"}}
/>

<APIResponse
  statusCode={"404"}
  description={"Provider not found."}
  contentType={"application/json"}
/>

<APIResponse
  statusCode={"400"}
  description={"Bad Request if provider does not use OAuth."}
  contentType={"application/json"}
/>

<APIResponse
  statusCode={"412"}
  description={"Precondition Failed if no OAuth credentials are available."}
  contentType={"application/json"}
/>

## Try It

<APIPlayground
  method={"POST"}
  path={"/v1/integrations/oauth/start"}
  parameters={[]}
  requestBody={{"contentType":"application/json","required":true,"description":"Information to start the OAuth flow.","schema":{"type":"object"}}}
  baseUrl={""}
/>


## Sitemap

See the full [sitemap](https://www.doc0.dev/docs/49c89830-117b-4def-8edc-b5bcc50766e0/llms.txt) for all pages in this wiki.