> ## Documentation Index
> Fetch the complete documentation index at: https://thehyperstack.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Google Forms Integration
> Automatically issue verifiable credentials to quiz participants based on their score — directly from Google Forms.
## Overview
The Hyperstack Google Forms Add-on lets you issue verifiable credentials to quiz participants who meet a minimum passing score. Once set up, credentials are automatically sent to qualifying participants' email addresses upon form submission.
**Prerequisites**
* A Hyperstack account with at least one **Credential Group** already created
* The [**Hyperstack Add-on**](https://workspace.google.com/marketplace/app/hyperstack/614338762241) installed from the Google Workspace Marketplace
* A Google account with access to Google Forms
***
## Video Tutorial
***
## Setup Guide
Open your Google Form, then go to **Add-ons → Hyperstack → Launch**.
A dialog will appear asking for your **API token key**. To get this:
1. Go to your **Hyperstack Dashboard → Settings → Developer**
2. Click **Create New API Key**
3. Copy the generated key
Paste the key into the add-on dialog and click **Save**.
Once authenticated, the add-on displays all **Credential Group** titles from your Hyperstack portal.
Choose the credential group you want to issue upon quiz completion.
If no credential groups appear, you must create one in your Hyperstack portal before continuing. Go to **Hyperstack → Credential Groups → New Group**.
Create your quiz questions in Google Forms as you normally would.
Make sure each question has **point values assigned** — the add-on uses total points as the passing criteria.
Take note of the total possible points across your quiz — you'll use this to set a meaningful minimum passing score in the next step.
In the add-on settings, enter the **minimum score** a participant must achieve to receive a credential.
For example, entering `2` means only participants who score 2 or more points will be issued a credential. Customize this based on the total point value of your quiz.
Click **Save** once done.
You must include a question that collects the participant's full name. The add-on uses this to identify the credential recipient.
**Requirements:**
* The question **title must contain "full name"** anywhere (case-insensitive)
* The field must be marked as **Required**
```text Valid question titles theme={null}
Enter your full name
Participant's Full Name
Please provide your full name
```
If the "full name" phrase is missing from the question title, the add-on will not be able to identify the participant's name and the credential will not be issued correctly.
Go to your form's **Settings → Responses** and toggle on **Collect email addresses**.
This is required so that the credential can be automatically delivered to the participant's email upon successful completion.
Your quiz form is now ready for distribution. Share it with participants using the standard Google Forms share link.
When a participant submits a response that meets or exceeds your minimum passing score, Hyperstack will automatically issue a verifiable credential to their email address.
You can view all issued credential details anytime from your **Hyperstack Portal**.
***
## How It Works
When a participant submits the form, the add-on:
1. Checks if the submission score meets the minimum passing threshold
2. Reads the participant's name from the "full name" question
3. Uses the collected email address as the credential delivery destination
4. Issues the credential via Hyperstack and sends it to the participant
***
## Troubleshooting
Check the following:
* Confirm the **minimum passing score** is set correctly in the add-on settings
* Ensure **Collect email addresses** is enabled under Form Settings → Responses
* Verify the full name question title contains the phrase **"full name"**
* Make sure the add-on is still connected — relaunch and confirm your API key is saved
This means your Hyperstack portal doesn't have any credential groups set up yet. Go to your **Hyperstack Portal → Credential Groups** and create one before using the add-on.
Your API key may have been deleted or expired. Go to **Hyperstack Dashboard → Settings → Developer**, generate a new key, and re-enter it in the add-on.
The most common reasons are:
* Their score did not meet the minimum passing threshold
* They didn't fill in the full name field (if it wasn't marked as required)
* Their email address wasn't collected (if the setting was toggled off)
***
## Related
Create and manage credential groups in your Hyperstack portal.
Issue credentials from any app using Zapier automation workflows.
Listen for credential events and build custom workflows.
Integrate Hyperstack directly into your own application via API.