What can you do with it?

Google Forms allows you to create and manage online forms programmatically. You can create new forms, add various types of questions (text, multiple choice, checkboxes, scales, dates), update existing forms, retrieve form responses, set up webhooks for real-time notifications, and manage form permissions. This integration is perfect for survey automation, feedback collection, and dynamic form generation. Note that listing all forms requires the Google Drive integration.

How to use it?

Basic Command Structure

/your-Google-Forms-connection [action] [required-parameters] [optional-parameters]

Parameters

Required:

  • action - The operation to perform on forms

Tools

Get Form

Retrieve form details, structure, and questions

Parameters:

  • form-id (required) - The ID of the form

Example:

/your-Google-Forms-connection
action: get-form
form-id: 1ABC123def456

Response:

{
  "formId": "1ABC123def456",
  "info": {
    "title": "Sample Form",
    "description": "This is a sample form"
  },
  "items": [
    {
      "itemId": "item123",
      "title": "What is your name?",
      "questionItem": {
        "question": {
          "textQuestion": {}
        }
      }
    }
  ]
}

Create Form

Create a new form with title and description

Parameters:

  • title (required) - Title for the new form
  • description (optional) - Description of the form

Example:

/your-Google-Forms-connection
action: create-form
title: Customer Feedback Survey
description: Please share your experience with our service

Response:

{
  "formId": "1XYZ789abc123",
  "info": {
    "title": "Customer Feedback Survey",
    "description": "Please share your experience with our service"
  },
  "responderUri": "https://docs.google.com/forms/d/1XYZ789abc123/viewform"
}

Update Form

Update form title, description or settings

Parameters:

  • form-id (required) - The ID of the form to update
  • title (optional) - New title for the form
  • description (optional) - New description for the form

Example:

/your-Google-Forms-connection
action: update-form
form-id: 1ABC123def456
title: Updated Customer Survey
description: New and improved feedback form

Response:

{
  "formId": "1ABC123def456",
  "info": {
    "title": "Updated Customer Survey",
    "description": "New and improved feedback form"
  }
}

Add Text Question

Add a text question to a form

Parameters:

  • form-id (required) - The ID of the form
  • question (required) - The question text
  • required (optional) - Whether the question is required (default: false)
  • position (optional) - Position index for the question

Example:

/your-Google-Forms-connection
action: add-text-question
form-id: 1ABC123def456
question: What is your email address?
required: true
position: 0

Response:

{
  "itemId": "item456"
}

Add Multiple Choice Question

Add a multiple choice question (radio, checkbox, or dropdown)

Parameters:

  • form-id (required) - The ID of the form
  • question (required) - The question text
  • type (required) - Question type: RADIO, CHECKBOX, or DROP_DOWN
  • options (required) - Comma-separated list of options
  • required (optional) - Whether the question is required
  • position (optional) - Position index for the question

Example:

/your-Google-Forms-connection
action: add-choice-question
form-id: 1ABC123def456
question: Choose your favorite color
type: RADIO
options: Red, Blue, Green, Yellow
required: true
position: 1

Response:

{
  "itemId": "item789"
}

Add Scale Question

Add a linear scale question

Parameters:

  • form-id (required) - The ID of the form
  • question (required) - The question text
  • low (required) - Lowest value on scale
  • high (required) - Highest value on scale
  • low-label (optional) - Label for low end
  • high-label (optional) - Label for high end
  • position (optional) - Position index

Example:

/your-Google-Forms-connection
action: add-scale-question
form-id: 1ABC123def456
question: How likely are you to recommend us?
low: 1
high: 10
low-label: Not at all likely
high-label: Extremely likely

Response:

{
  "itemId": "item321"
}

Update Question

Update an existing question

Parameters:

  • form-id (required) - The ID of the form
  • item-id (required) - The ID of the question to update
  • question (required) - Updated question text
  • options (optional) - Updated options for choice questions

Example:

/your-Google-Forms-connection
action: update-question
form-id: 1ABC123def456
item-id: item789
question: Select your preferred colors
options: Red, Blue, Green, Yellow, Purple

Response:

{
  "itemId": "item789"
}

Delete Question

Remove a question from a form

Parameters:

  • form-id (required) - The ID of the form
  • item-id (required) - The ID of the question to delete

Example:

/your-Google-Forms-connection
action: delete-question
form-id: 1ABC123def456
item-id: item789

Response:

{
  "status": "deleted"
}

Get Responses

Retrieve all form responses

Parameters:

  • form-id (required) - The ID of the form

Example:

/your-Google-Forms-connection
action: get-responses
form-id: 1ABC123def456

Response:

{
  "responses": [
    {
      "responseId": "response123",
      "createTime": "2023-06-15T10:30:45.123Z",
      "answers": {
        "item123": {
          "textAnswers": {
            "answers": [
              {
                "value": "John Doe"
              }
            ]
          }
        },
        "item789": {
          "textAnswers": {
            "answers": [
              {
                "value": "Blue"
              }
            ]
          }
        }
      }
    }
  ]
}

Set Up Webhook

Set up a webhook to receive form submissions

Parameters:

  • form-id (required) - The ID of the form
  • webhook-url (required) - URL to receive notifications

Example:

/your-Google-Forms-connection
action: setup-webhook
form-id: 1ABC123def456
webhook-url: https://your-webhook-endpoint.com/callback

Response:

{
  "id": "watch123",
  "expiryTime": "2023-07-15T10:30:45.123Z"
}

Notes

Form IDs and Item IDs are required for most operations and must be obtained from existing forms. To list all forms, use the Google Drive integration. Question types include text, paragraph text, multiple choice (radio/checkbox/dropdown), linear scale, date, time, and file upload. Form responses are returned with answers mapped to their corresponding item IDs.