Found something off? Report it here. This helps us fix issues faster during the Briedo pilot.
← Documentation

Connect your sources

Typeform

Turn a form submission into a piece of work with its answers.

What it does

Somebody completes your Typeform, and Briedo starts a piece of work with their answers already in it. Because the person answered the questions themselves, their answers count as theirs.

What Briedo reads

  • The submission that triggered the rule, and the answers you mapped.
  • Nothing about your account, your other forms, or earlier responses.

What Briedo may write

Nothing. This connection is one-way.

Permissions you are granting

None in the OAuth sense. Typeform sends Briedo a signed message when a form is submitted; Briedo verifies the signature and reads the submission. Briedo holds no key that could read your account.

How to connect

  1. Go to Settings, then Integrations, then Before discovery.
  2. Add a form connection. Briedo gives you an address and a secret.
  3. In Typeform, add a webhook on the form, paste the address, and set the secret as the webhook secret.
  4. Save the secret somewhere safe now. It is shown once and cannot be retrieved.

How to route work

  1. Add a rule that fires when A form is submitted.
  2. Map Contact email from the field that collects it. It is required.
  3. Choose which service this form is for.

How mapping works

Map each Typeform field onto the Briedo item it answers. Give your fields stable references in Typeform and use those, rather than question text — editing a question’s wording should not break your mapping.

How to test it

  1. Submit your own form with realistic answers.
  2. Confirm a piece of work appears in Briedo.
  3. Confirm the mapped answers are on it, attributed to the form.
  4. Submit again to confirm you get a second piece of work and not a duplicate of the first.

How to know it is working

  • Each submission produces exactly one piece of work.
  • The answers are there, shown as coming from the form.
  • Nobody is asked again for something the form already collected.

When it goes wrong

What you seeWhat it means
Typeform reports a delivery failureThe secret does not match. Rotate it in Briedo and update Typeform.
Work is created with no answersThe rule has no field mappings, or they point at fields the form no longer has.

How to disconnect

Remove the webhook in Typeform, then revoke the connection in Briedo. Revoking stops Briedo accepting anything signed with that secret, even if the webhook is still configured.

What happens to what it already told us

Nothing is deleted. Work that was already prepared keeps everything it learned, including the record that this system is where it came from. Those are records of what was true at the time, and disconnecting a system later does not make them untrue.

What stops is new information arriving. Deleting historical data is a separate request, and a deliberate one.

Something else?

All guides →