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

Start Native OAuth

cURL

curl --request POST \
  --url https://api.duvo.ai/v2/teams/{teamId}/connections/oauth/native/{provider}/start \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

200

{
  "authorization_url": "<string>"
}

Authorizations

Authorization · string · header · required

API key authentication. Get your API key from the Duvo dashboard.

Path Parameters

provider · string · required

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

teamId · string · required

Body

application/json

return_url · string

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

{key} · string

Response

200

application/json

Default Response

authorization_url · string · required

OAuth provider authorization URL to open in a browser