v1

latestOpenAPI 3.0.32026-07-222111928.0 KB
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

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