Skip to main content

​
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 installed from the Google Workspace Marketplace
  • A Google account with access to Google Forms

​
Video Tutorial

​
Setup Guide

1

Launch the Add-on & Enter Your API Key

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.
2

Select a Credential Group

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.
3

Build Your Quiz Form

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.
4

Set the Minimum Passing Score

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.
5

Add a Full Name Question

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
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.
6

Enable Email Collection

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.
7

Share Your Form

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)

Credential Groups

Create and manage credential groups in your Hyperstack portal.

Zapier Integration

Issue credentials from any app using Zapier automation workflows.

Webhooks

Listen for credential events and build custom workflows.

REST API

Integrate Hyperstack directly into your own application via API.
Last modified on February 22, 2026