Initialize google oauth

Creates an OAuth session and returns the Google authorization URL. The user should be redirected to auth_url to complete the OAuth flow. Poll the status endpoint to check for completion.

Special rate limits (stricter than the standard API rate limit) to comply with upstream Google rate limits:

• 75 requests per minute per workspace
• 150 requests per minute per IP

If Google’s upstream OAuth service is temporarily unavailable, requests may return 503.

POST /api/v2/oauth/google/init

Initialize google oauth

cURL

curl --request POST \
  --url https://api.instantly.ai/api/v2/oauth/google/init \
  --header 'Authorization: Bearer <token>'

200

{
  "session_id": "abc123def456",
  "auth_url": "https://accounts.google.com/o/oauth2/auth?...",
  "expires_at": "2026-01-14T12:30:00.000Z"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

200

application/json

Default Response

session_id · string

Session ID for polling status

Example:

"abc123def456"

auth_url · string

Google authorization URL to redirect user to

Example:

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

expires_at · string<date-time>

Session expiry time (10 minutes from creation)

Example:

"2026-01-14T12:30:00.000Z"