Connections

Start Native OAuth

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.

post/v2/teams/{teamId}/connections/oauth/native/{provider}/start

Request

Base URL
https://api.duvo.ai
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.

Path parameters

providerstring required

OAuth provider slug (e.g. 'google', 'gmail', 'googlesheets', 'outlook'). Must match a configured native OAuth provider.

teamIdstring required

Request body

return_urlstring

Where to send the user's browser after OAuth completes.

reconnect_instance_idstring uuid

When set, the OAuth flow will update the existing connection in place rather than creating a new one.

Response

Default Response

authorization_urlstring required

OAuth provider authorization URL to open in a browser

Changes

No recorded changes to this operation across all 1 revision of this API.