---
title: "POST /v3/connections/google-docs/token"
method: POST
path: "/v3/connections/google-docs/token"
tags: ["connections"]
---

# POST /v3/connections/google-docs/token

`POST /v3/connections/google-docs/token`

Get a valid Google access token for a connected Google account. Automatically refreshes the token if expired.

## Request body

- object
  - `email` string, required — The Google account email

## Response `200`

Default Response

- object
  - `access_token` string, required — A valid Google access token
  - `granted_scopes` string[] — The scopes granted by the user during OAuth (may be a subset of requested scopes)

## Other responses

- `404` — Default Response
- `500` — Default Response

## Changes

- **2026-08-05** `4d8b6d2e6db3` — 1 info
  - removed the non-success response with the status `403`
- **2026-05-14** `eee85d2eafce` — 1 warning
  - the `email` request property's maxLength was set to `320`
- **2026-01-15** `788eacc57f25` — 1 info
  - added the non-success response with the status `500`
- **2026-01-05** `3ac7e8a7f794` — 1 info
  - added the optional property `granted_scopes` to the response with the `200` status
- **2025-12-29** `8ced33764d35` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/val-town/apis/val-town-api/changes/v3/connections/google-docs/token/post.md)

---

[API](https://skmtc.dev/val-town/apis/val-town-api.md) · [All operations](https://skmtc.dev/val-town/apis/val-town-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/val-town/val-town-api/revisions/4d8b6d2e6db3/schema)