Typeform Integration

The Typeform integration connects your Typeform account to your Hyperstack organization. With it you can:

• Map each Typeform form to a credential group.
• Pick which questions give the name and the email on the credential. Any question works, hidden fields too.
• Add a rule, so only some responses issue a credential. For example: Score (quiz) is at least 8.
• See every response on the Logs tab, with the credential it issued or the reason it issued nothing.

You sign in to Typeform once. Hyperstack adds the webhooks to your forms for you: you don’t copy an API key or a URL, and you don’t need Zapier.

​

Before you start

• Hyperstack: any plan. You must be an administrator of the organization.
• Typeform: a Typeform account that can see the forms you want to use, on a Typeform plan that includes webhooks. Check your plan in Typeform.
• At least one credential group with its design, or let Sync forms create them for you.

One Typeform account connects to one Hyperstack organization. Hyperstack sees every form that the Typeform account can see.

​

Step 1: Connect Typeform

​

Step 2: Map your forms to credential groups

• To map one form, click Choose group on its row, type to search, and pick a credential group.
• To map many forms at once, click Sync forms. Hyperstack creates a credential group for each form that is not mapped yet, named after the form, with the design you pick.

​

Step 3: Pick the name, the email and an optional rule

Each mapped form has a Name and email column. It says Matched by label until you pick. Then Hyperstack reads the Email question and a question named Name or Full name (or First name and Last name). To pick the questions yourself, click the button in the Name and email column.

• Name: the question whose answer is the name on the credential.
• Add to the name (optional): a second question added after the first one. Use it for a Contact info block, which asks for the first name and the last name separately.
• Email: the question whose answer is the email address. Hyperstack sends the credential there. A hidden field works too, so you can put the email in the form’s link.
• Only issue when (optional): pick a question, a comparison and a value.

For a multiple-choice or dropdown question, Hyperstack compares the text of the option. A Yes/No question answers yes or no. Click Save. The column shows what you picked, for example First name + Last name · Email and Only if Score is at least 8.

​

Step 4: Turn on auto-issue

Click Turn on under Auto-issue on form submission. Hyperstack adds one webhook to each mapped form in Typeform. In Typeform, the webhook shows on the form’s Connect → Webhooks tab, with an address on api.thehyperstack.com and Webhook ON. Don’t change or delete it there: Hyperstack manages it. Now, when someone submits a mapped form, they get that group’s credential. Hyperstack issues and publishes it at once, and sends the email if the group sends one.

​

Check what happened: the Logs tab

The Logs tab lists every response that Typeform sends, for 90 days.

• Issued: a credential was created. Its ID shows in the Credentials column.
• Skipped: nothing was issued, and the line says why. For example: the rule wasn’t met, the email answer isn’t an email address, or the person already has a credential in that group.
• Failed: the call was refused, for example because its signature didn’t match.

Click a row to see the full response that Typeform sent.

​

Good to know

• One credential per email per group. If a person submits the form again, nothing new is issued.
• What Hyperstack keeps: Typeform’s sign-in tokens and the Typeform account’s email. A credential keeps only the form, the response token and the time. Hyperstack doesn’t copy the form answers into the credential.
• Security: each webhook is signed with a secret that only Hyperstack and Typeform know. Hyperstack refuses a call with a wrong signature.
• Turn off auto-issue to stop issuing but keep your mappings. Hyperstack removes the webhooks from your forms.
• EU Responses Data Center: if your Typeform account keeps responses in the EU data center (Typeform Enterprise), contact us before you connect.

​

Disconnect Typeform

Click the ⋯ button at the top right of the Typeform page, then Disconnect Typeform. Hyperstack removes its webhooks from your forms in Typeform and deletes your mappings. Credentials you already issued stay as they are. To also remove Hyperstack’s access in Typeform, open your Typeform account settings and remove Hyperstack from the apps that have access.

​

Troubleshooting

Questions or problems: support@thehyperstack.com.