> ## Documentation Index
> Fetch the complete documentation index at: /docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Build Google Forms and Read Responses With Agents

> Let agents create Google Forms, add questions, and analyze submissions through the Forms API. The gateway handles OAuth so agents never touch tokens.

> [!WARNING]
>
> **Per-app Google setup is deprecated.** All Google apps now share one Google OAuth client and one Redirect URI. To use your own client, follow the [Google setup guide](/docs/integrations/google.md). Credentials saved for one Google app apply to all of them.

## Overview

Buckle connects AI agents to Google Forms through Google's OAuth flow. Agents can create forms, add questions, and read submitted responses. The gateway injects OAuth credentials into requests to the Google Forms API automatically.

This is useful for agents that need to collect feedback, create surveys, or process form submissions.

## What you will set up

* A Google OAuth client shared by every Google app in Buckle
* A Google Forms connection authorized with your account
* Per-agent, per-tool access to forms and responses

## Connect Google Forms

> [!NOTE]
>
> This applies on Buckle Cloud and self-hosted alike. One Google client serves every Google app in Buckle, so you set it up once. If you already did it for another Google app, skip to step 2.

> [accordion] 1. Set up your Google client
>
> Follow the [Google setup guide](/docs/integrations/google.md). It enables the Google APIs, sets up the consent screen, creates the OAuth client, and adds the Redirect URI.

> [accordion] 2. Connect Google Forms
>
> Open **Settings** > **Apps** > **Google Forms**, select **Connect Google Forms**, pick your Google account, and click **Allow**.
>
> ![Buckle connect window for Google Forms showing Configuration required, the setup guide link, and the Configure credentials button.](https://mintcdn.com/onecli-17d3f772/hJP3XqgFsBDnXHKy/images/integrations/google-forms/buckle-connect-google-forms.png?fit=max\&auto=format\&n=hJP3XqgFsBDnXHKy\&q=85\&s=5697ddadd006ff76c3f115cd8a5850e4)
>
> The Google Forms connect window before a Google client is set up.

## What agents can do

* Create new forms with a title and description
* Add questions (multiple choice, short answer, paragraph, checkbox, dropdown, scale)
* Read form structure (questions, sections, settings)
* Read all submitted responses
* Get individual response details
* Set up and manage response watches (notifications for new submissions)
* Update form metadata (title, description)
* Modify existing questions

## Controlling access

Access is per agent: [grant](/docs/guides/agent-access.md) the connection to each agent that needs it, choosing per tool what runs freely, what needs human approval, and what stays blocked — a read-only agent is a single grant. Organization [rules](/docs/guides/rules.md) add guardrails on top, like rate limits and blanket blocks. Everything is checked before credential injection, so a blocked request never reaches Google Forms.

## FAQ

> [accordion] Do I need my own Google client for Forms?
>
> Yes. Follow the [Google setup guide](/docs/integrations/google.md) once. One client serves every Google app in Buckle.

> [accordion] Does the agent see my Google token?
>
> No. The token stays in Buckle, and the gateway adds it at the proxy. See [How it works](/docs/how-it-works.md).

> [accordion] Can an agent read responses without editing forms?
>
> Yes. Allow read tools and block writes when you [grant](/docs/guides/agent-access.md) the connection.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.