# Google Forms API (slim)

> REST API from Google for creating and editing Google Forms forms and quizzes, reading responses and quiz grades, and subscribing to change notifications through Cloud Pub/Sub. Access is by OAuth 2.0.

- Full: https://www.anchorterminal.com/tools/google-forms.md (~9,450 tokens) · this version ~1,680 tokens · JSON https://www.anchorterminal.com/tools/google-forms.json · canonical https://www.anchorterminal.com/tools/google-forms
- Index: https://www.anchorterminal.com/llms.txt · API: https://www.anchorterminal.com/api/v1/index.json · Updated: 2026-10-08

**BB · 70.8/100 · rank #127 of 722 · #1 in Forms, surveys & structured intake · agent-ready · confidence medium**


Assessment: Six OAuth scopes separate form structure from responses, and batchUpdate applies a batch atomically with a revision check. Notifications go only to a Cloud Pub/Sub topic and carry no response data, the API can't list forms or create file upload questions, and the release notes were last updated on 8 April 2025.

## Facts

- Kind: HTTP API · vendor: Google · category: Forms, surveys & structured intake · legal entity: Google LLC · provenance 94/100
- Endpoint: `https://forms.googleapis.com/v1` (HTTP)
- Auth: OAuth · pricing: Free · x402: no · licence: Proprietary service under the Google APIs Terms of Service. The client libraries are Apache-2.0
- Probe metrics: not measured yet (probes haven't run)
- Price: No charge for standard use. Charges for exceeding quota are planned for later in 2026, unpriced, with 90 days' notice. Cloud Pub/Sub for notifications is billed separately
- Quota: Per minute per project, 975 reads, 450 forms.responses.list calls and 375 writes. Per user per project, 390, 180 and 150. No daily limit
- Interface: REST at https://forms.googleapis.com/v1, 10 methods in discovery revision 20261004, on forms, forms.responses and forms.watches
- Building a form: forms.create takes a title only. forms.batchUpdate adds and edits items atomically, with six request kinds and a revision check. forms.setPublishSettings publishes
- Question types: Choice (radio, checkbox, drop-down), text, scale, date, time, rating and grid rows, plus sections, text, image and video items. File upload questions can be read but not created
- Responses: forms.responses.get and list, read-only. Answers are keyed by question ID and returned as text, with grades for quizzes. pageSize, pageToken and a timestamp filter
- Notifications: Watches on SCHEMA or RESPONSES events, sent to a Cloud Pub/Sub topic. Seven-day expiry, at-least-once, no payload beyond form, watch and event type
- Scopes: forms.body, forms.body.readonly, forms.responses.readonly, drive, drive.file, drive.readonly
- MCP server: None found for Forms. Google's Workspace MCP servers cover Gmail, Drive, Docs, Sheets, Slides, Calendar and Chat
- Client libraries: Google API client libraries, Apache-2.0. `@googleapis/forms` 11.0.1 (24 September 2026, Node 22 or later) and `google-api-python-client` 2.201.0 (30 September 2026)

- Scores: Reliability 91, Performance pending, Schema & documentation 78, Agent ergonomics 72, Security & auth 66, Payments & pricing 35, Task success pending, Maintenance & community 61, Transparency & trust 80 · total over the 7 assessed categories
- Why: Reliability, Graded on the REST API, the only surface. · Schema & documentation, Google publishes a discovery document, not OpenAPI, which is a machine-readable contract all the same, at revision 20261004 with 10 methods… · Agent ergonomics, Responses size with a fields mask and pageSize, and batchUpdate returns the form only when includeFormInResponse is set. · Security & auth, OAuth 2.0 with six scopes and short-lived revocable tokens (30), less 10 because the discovery document lists access_token, oauth_token and… · Payments & pricing, No x402, MPP or L402 (0). · Maintenance & community, The API's own release notes were last updated on 8 April 2025. The discovery document is at revision 20261004 and `@googleapis/forms` 11.0.1… · Transparency & trust, Closed service under the Google APIs Terms of Service, last modified 9 November 2021, with Apache-2.0 client libraries (15 of 30).
- Sources: 38, open questions: 10, both in the full twin
- Capabilities: forms.create, forms.responses, forms.webhooks, forms.surveys
- JSON: https://www.anchorterminal.com/api/v1/tools/google-forms.json
- Verify (for the vendor): the badge `https://www.anchorterminal.com/badges/google-forms.svg` or a link to https://www.anchorterminal.com/tools/google-forms from a page on google.com or one of its subdomains, or the README of github.com/googleapis/google-api-nodejs-client, then `POST https://www.anchorterminal.com/api/v1/verify` `{"slug", "url"}` or `verify_listing` at /mcp; re-checked weekly, no effect on the grade. Snippets in the full twin.

## Before you call it

1. Call forms.create with a title only, then add items with forms.batchUpdate. Any other field in the create body is disallowed
2. Publish with forms.setPublishSettings before sharing. Google's notice says forms created through the API after 30 June 2026 start unpublished
3. Pass pageSize on forms.responses.list. With none set a page can hold up to 5,000 responses. Use filter=timestamp > N to fetch only new ones
4. After a Pub/Sub notification, call forms.responses.list yourself. The message holds only formId, watchId and eventType. Renew each watch within seven days
5. Send writeControl.requiredRevisionId on forms.batchUpdate, and read the form before retrying a timed-out forms.create, which has no idempotency key

## Connect

```bash
npm install @googleapis/forms
```

```bash
curl "https://forms.googleapis.com/v1/forms/$FORM_ID/responses?pageSize=50" \
  -H "Authorization: Bearer $GOOGLE_ACCESS_TOKEN"
```
Full config and headless snippets are in the full page. Through letme (picks today, calling later): https://letme.dev/google-forms

## Similar tools

| Tool | Grade | Score | Shared capabilities | Slim |
| --- | --- | --- | --- | --- |
| Tally | C | 60.6 | forms.create, forms.responses, forms.webhooks, forms.surveys | https://www.anchorterminal.com/tools/tally.min.md |
| Typeform | C | 58.4 | forms.create, forms.responses, forms.webhooks, forms.surveys | https://www.anchorterminal.com/tools/typeform.min.md |
| Formbricks | C | 57.7 | forms.surveys, forms.create, forms.responses, forms.webhooks | https://www.anchorterminal.com/tools/formbricks.min.md |
| SurveyMonkey | C | 55.3 | forms.create, forms.surveys, forms.responses, forms.webhooks | https://www.anchorterminal.com/tools/surveymonkey.min.md |
| Jotform | D | 52.9 | forms.create, forms.responses, forms.webhooks, forms.surveys | https://www.anchorterminal.com/tools/jotform.min.md |


## Panel reviews (0, desk reviews from public material, no calls made)