---
title: "Start Native OAuth"
method: POST
path: "/v2/teams/{teamId}/connections/oauth/native/{provider}/start"
tags: ["Connections"]
---

# Start Native OAuth

`POST /v2/teams/{teamId}/connections/oauth/native/{provider}/start`

## Request

- Base URL: `https://api.duvo.ai`
- URL: `https://api.duvo.ai/v2/teams/{teamId}/connections/oauth/native/{provider}/start`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/duvo/apis/duvo-public-api/docs/v2/teams/:teamId/connections/oauth/native/:provider/start/post.ts> (a function with typed inputs; its response is checked against the schema)

Start an OAuth-based connection with a native provider (Gmail, Google Sheets, Outlook, etc.). Returns an authorization URL that must be opened in a browser by a human end-user; once they grant consent, Duvo creates the matching connection and redirects the browser to the optional `return_url` (or the Duvo dashboard if none is provided). Poll `/v2/teams/:team_id/connections` to detect the new connection.

## Path parameters

- `provider` string, required
- `teamId` string, required

## Request body

- object
  - `return_url` string: Where to send the user's browser after OAuth completes.
  - `reconnect_instance_id` string, uuid: When set, the OAuth flow will update the existing connection in place rather than creating a new one.

## Response `200`

Default Response

- object
  - `authorization_url` string, required: OAuth provider authorization URL to open in a browser

## Other responses

- `401`: Default Response
- `404`: Default Response
- `500`: Default Response

---

[API](https://skmtc.dev/duvo/apis/duvo-public-api.md) - [All operations](https://skmtc.dev/duvo/apis/duvo-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/duvo/apis/duvo-public-api/revisions/dafcf3d868a9?raw)