Skip to main content
POST
Connect Email Provider (Initiate OAuth)

Authorizations

x-api-key
string
header
required

Your API key for authentication. Use sandbox-with-json-responses as Sandbox key.

Body

application/json
redirect_uri
string<uri>
required

Your callback URL to receive the inbox_token (must be http or https)

Example:

"https://yourapp.com/oauth-callback"

state
string

State parameter for CSRF protection (returned in redirect)

Example:

"abc123"

Response

OAuth URL generated successfully

status
string
Example:

"success"

oauth_url
string<uri>

Redirect user to this URL to start OAuth flow

Example:

"https://accounts.google.com/o/oauth2/v2/auth?client_id=..."

expires_in
integer

Seconds until the OAuth URL expires (typically 10 minutes)

Example:

600