Skip to main content

Create Form

Creates a new Google Form or Quiz.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.

Inputs​

  • Title - The title for the new Google Form or Quiz.

Options​

  • Credentials - The Google Forms API credentials used to authenticate with the service.
  • Type - The type of document to create:
    • Form - A standard Google Form for collecting responses
    • Quiz - A Google Form with grading capabilities

Output​

  • form_id - The unique identifier of the newly created form.

How It Works​

The Create Form node creates a new Google Form or Quiz. When executed, the node:

  1. Validates the required input (Title)
  2. Retrieves the Google Forms API credentials
  3. Validates the form type selection
  4. Uses the Google Forms API to create a new form with the specified title and type
  5. Returns the ID of the newly created form

Requirements​

  • Valid Google Forms API credentials
  • Appropriate permissions to create forms
  • Valid form title

Error Handling​

The node will return specific errors in the following cases:

  • Empty or invalid Title
  • Invalid or missing Credentials
  • Invalid Type selection
  • Google Forms API errors during form creation
  • Insufficient permissions to create forms

Usage Notes​

  • The form will be created with the specified title
  • Forms and Quizzes are similar, but Quizzes have additional grading features
  • The returned form_id can be used with other Google Forms nodes to modify the form
  • The form will be created in the Google Drive account associated with the credentials
  • Newly created forms are initially empty and require additional nodes to add questions
  • The form URL format is: https://docs.google.com/forms/d/{form_id}/edit

Example Use Cases​

Create Customer Feedback Survey​

Title: "Customer Satisfaction Survey - Q1 2024"
Type: Form
Credentials: service-account-credentials

Output: form_id → Use with AddClosedEndedQuestion to add rating questions

Generate Quiz for Training Program​

Title: "Employee Safety Training Assessment"
Type: Quiz
Credentials: oauth2-user-credentials

Output: form_id → Use with AddClosedEndedQuestion (with correct answers) to build quiz

Event Registration Form​

Title: "Annual Conference Registration 2024"
Type: Form
Credentials: service-account-credentials

Output: form_id → Add contact information and preference questions

Automated Daily Feedback Collection​

Flow:
1. Create Form: "Daily Team Standup - {{current_date}}"
2. Add questions about progress, blockers, and goals
3. Share form URL with team
4. Collect responses later with GetResponses

Tips for Effective Use​

  • Form vs Quiz: Choose "Form" for data collection without grading; choose "Quiz" when you need to evaluate answers and assign points
  • Naming Convention: Include dates, versions, or identifiers in the title for better organization (e.g., "Customer Survey - 2024-01", "Quiz v2.0")
  • Store Form IDs: Save the returned form_id to a variable or database for later reference and modification
  • Batch Creation: Use loops to create multiple forms from templates (e.g., creating weekly feedback forms)
  • Combine with Sheets: After creating a form, link it to a Google Sheet for automatic response storage
  • Form URL Access: The form can be edited at https://docs.google.com/forms/d/{form_id}/edit and shared at https://docs.google.com/forms/d/{form_id}/viewform

Common Errors and Solutions​

Error: "Missing client_id or client_secret in credentials"​

Cause: OAuth2 credentials are incomplete or malformed. Solution: Ensure your credentials file contains both client_id and client_secret fields. If using OAuth2, obtain proper credentials from Google Cloud Console.

Error: "Invalid credentials format: missing content field"​

Cause: Credentials vault item is not properly formatted. Solution: Verify that credentials are stored correctly in the vault with a content field containing the JSON credentials.

Error: "Title cannot be empty"​

Cause: The Title input is empty or not provided. Solution: Provide a non-empty string as the form title. Use variables or expressions if needed.

Error: "Type must be selected"​

Cause: The Type option is not set or has an invalid value. Solution: Select either "Form" or "Quiz" from the Type dropdown in the node options.

Error: "Insufficient permissions to create forms"​

Cause: The service account or OAuth2 user doesn't have permission to create forms. Solution:

  • For Service Accounts: Ensure the service account has proper domain-wide delegation
  • For OAuth2: Verify the user has granted the required Forms API scopes
  • Check that the Google Forms API is enabled in your Google Cloud project

Integration Examples​

Create Form and Add Questions Workflow​

1. Create Form Node
   - Title: "Employee Onboarding Survey"
   - Type: Form
   - Output: form_id (e.g., "1ABC123xyz")

2. Add Open-Ended Question Node
   - Form Id: {{form_id}}
   - Question Title: "What are your career goals?"
   - Index: 1
   - Type: Paragraph

3. Add Closed-Ended Question Node
   - Form Id: {{form_id}}
   - Question Title: "How did you hear about us?"
   - Answers: ["LinkedIn", "Job Board", "Referral", "Company Website"]
   - Index: 2
   - Type: Radio

Dynamic Quiz Creation from Database​

1. Query Database for quiz questions
2. Create Form Node
   - Title: "{{quiz_name}}"
   - Type: Quiz
   - Output: form_id

3. For each question in database:
   - Add Closed-Ended Question
   - Form Id: {{form_id}}
   - Question Title: {{question.text}}
   - Answers: {{question.options}}
   - Correct Answers: {{question.correct}}
   - Point: {{question.points}}
   - Index: {{loop.index}}