---
title: "Initialize google oauth"
method: POST
path: "/api/v2/oauth/google/init"
tags: ["OAuth"]
---

# Initialize google oauth

`POST /api/v2/oauth/google/init`

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.

## Response `200`

Default Response

- object
  - `session_id` string — Session ID for polling status
  - `auth_url` string — Google authorization URL to redirect user to
  - `expires_at` string, date-time — Session expiry time (10 minutes from creation)

## Other responses

- `429` — Rate limit exceeded — 75 requests per minute per workspace or 150 requests per minute per IP
- `503` — Upstream provider temporarily unavailable — the provider is rate-limiting Instantly. Retry after a short delay.

---

[API](https://skmtc.net/instantly/apis/api-explorer.md) · [All operations](https://skmtc.net/instantly/apis/api-explorer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/instantly/api-explorer/revisions/378d1e253fe7/schema)