formbasedocs
Go to appApp

Guides · Zapier

Send a request from a Zap

A request asks one named recipient to complete a form. This guide adds a Create Request step to a Zap, prefills the recipient's name so they cannot change it, and hands the link to the next step.

Last checked


You need a formbase connection in Zapier and a published form. What a request is, and every option it takes, is in Creating requests; this guide shows where those options sit in Zapier.

1. Add the Create Request step

Start with the trigger that should send the request: a deal marked won in your CRM, a new row in Google Sheets, a scheduled date. Add an action, choose formbase, and pick Create Request.

2. Pick the form, the recipient and the delivery

The Create Request step: Form Approval, Recipient Email ada@acme.example, Recipient Name Ada Lovelace, Language empty, Delivery 'None: the Zap sends the link itself'
  • Form is the form the recipient completes. It must be published.

  • Recipient Email and Recipient Name usually come from the trigger. The email is needed for email delivery and for reminders.

  • Language is one of the form’s published languages, like de. Leave it empty for the form’s default.

  • Delivery decides who sends the link. Email lets formbase send the invitation and reminders, and needs a Pro or Business plan. None, the default, sends no invitation: a later step of your Zap sends the Request URL, by Slack, SMS or your own email tool. If the form has Send reminders on and you fill in Recipient Email, formbase still emails the scheduled reminders. To send none at all, leave Recipient Email empty.

3. Prefill and lock what you already know

Once you pick the form, each question you can prefill appears below as a field, named after its field key. Signature, file upload, payment, appointment and calculated questions have none. Fill in any answer you already have; the recipient sees it filled in. Add a question to Read-only fields to lock it, so the recipient can see it but not change it. A locked question must also be prefilled.

Test Request set to False, Your Name prefilled with Ada Lovelace, Your Decision and What should change? left empty, and Your Name picked under Read-only fields

The recipient opens the link and finds their name filled in and locked:

The request form with Your Name showing Ada Lovelace in a greyed-out field and the note 'Locked because this answer came with your request.'

Hidden fields of the form show up as (context) fields: the recipient cannot change them and sees them only where the form mentions them, and they come back both in the request’s Context and among the answers. If the form has a Documents block, a Documents field takes files from earlier steps. See Prefill, locked fields, and context for the difference.

4. Set an External ID

Put your own id for this piece of work in External ID, like the deal number deal-1042. It does two jobs:

  • A later Zap can look the request up with Find Request, without storing formbase’s request ID.

  • It is the idempotency key. If Zapier replays the step with the same External ID and the same inputs, you get the same request back instead of a second one. Deduplicated is then true. The same External ID with any input changed, within 30 days, fails with Idempotency key … was already used for a different request. Use a new External ID for each request, like deal-1042-onboarding, and a fresh one when you change a test step’s inputs, including Test Request.

Reminders, Expires At and Metadata are optional. A request expires after 30 days unless you set another date, at most 365 days away.

5. Test the step

Click Test step. formbase creates the request and returns it. Request URL is the link for the recipient; map it into the step that sends it.

The Data out tab of the Create Request test: Created At and Expires At as dates, Deduplicated false, Delivery Status not_requested, External ID deal-1043, Status pending and a Request URL on form.formbase.so
Delivery Status is not_requested because Delivery is None: formbase sent nothing.

Next