---
title: "Initiate Connection"
method: POST
path: "/api/focused/google/initiate-connection"
tags: ["Google Connection"]
---

# Initiate Connection

`POST /api/focused/google/initiate-connection`

Generate a secure, single-use token for Google OAuth initiation.

Returns an opaque token that can be used in a browser URL.
The token expires in 10 minutes and can only be used once.

Security:
    - Token is cryptographically random (secrets.token_urlsafe)
    - Token stored in Redis with 10-minute TTL
    - Token deleted after first use (single-use)
    - user_id never exposed in URL

Args:
    request: FastAPI request object
    x_user_id: User ID from JWT (set by MCP after token validation)

Returns:
    200: {
        "token": "dBjftJeZ4CVP-mB92K27uhbUJU1p1r_wW1gFWFOEjXk",
        "connect_url": "https://api.priority-guard.com/auth/google/start?token=...",
        "expires_in": 600
    }
    500: If Redis is unavailable

## Headers

- `X-User-ID` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/priority-guard/apis/priority-guardian.md) · [All operations](https://skmtc.net/priority-guard/apis/priority-guardian/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/priority-guard/priority-guardian/revisions/8579218b716d/schema)