Build an OAuth/OIDC authorization URL for connecting this traffic source to a provider.

post

https://platform.routy.app/api/v1/traffic-sources/{trafficSourceId}/integrations/auth/{provider}/authorize

Requires the TrafficSourceWrite policy. A missing RedirectUri in the body yields 400. The route provider overrides the body provider.

🔐 Required permissions: traffic-source.read, traffic-source.update

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

trafficSourceId

int32

required

Traffic source ID.

provider

string

enum

required

Provider type (TrafficSourceProvider enum).

Body Params

Authorization request with OIDC parameters.

Enhanced authorization request supporting OIDC with PKCE and state parameters

provider

string

enum

Provider to authorize with

integrationId

int32

Integration ID for tracking purposes

redirectUri

string | null

Redirect URI where the authorization server will redirect after user consent

state

string | null

State parameter for CSRF protection (auto-generated if not provided)

codeVerifier

string | null

PKCE code verifier (auto-generated if not provided)

codeChallengeMethod

string | null

PKCE code challenge method (S256 recommended)

additionalScopes

array of strings | null

Additional scopes to request beyond the default provider scopes

additionalScopes

customParameters

object | null

Provider-specific parameters (e.g., prompt=consent for Google)

loginHint

string | null

domainHint

string | null

Domain hint for Google Workspace accounts (e.g., "example.com")

isPopupFlow

boolean

Whether this is a popup-based OAuth flow

consentOptions

object | null

Additional consent screen customization options

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

content-type

string

enum

Defaults to application/json

Generated from available request content types

Allowed:

Responses

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

text/plain

application/json

text/json

200The authorization URL.

400Bad Request

401Unauthorized

403Forbidden

500Internal Server Error