---
title: "Start a PKCE-protected Gmail mailbox connection for this workspace."
method: POST
path: "/v1/workspaces/{workspaceId}/providers/google/oauth/session"
---

# Start a PKCE-protected Gmail mailbox connection for this workspace.

`POST /v1/workspaces/{workspaceId}/providers/google/oauth/session`

## Request

- Base URL: `https://api.bangermail.com`
- URL: `https://api.bangermail.com/v1/workspaces/{workspaceId}/providers/google/oauth/session`
- Auth: HTTP bearer

## Response `200`

Gmail authorization URL and poll contract.

- object
  - `session` GmailOAuthSessionStart, required
    - `sessionId` string, uuid, required
    - `authUrl` string, uri, required
    - `expiresAt` integer, required
    - `pollIntervalMs` integer, required

---

[API](https://skmtc.dev/bangermail/apis/banger-api.md) · [All operations](https://skmtc.dev/bangermail/apis/banger-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bangermail/apis/banger-api/revisions/a149909267f9?raw)