When a webhook is received is a trigger that starts an automation when another system sends data to a web address that Tape gives you (the trigger decides when an automation starts, and the actions decide what happens). It's meant to help you bring data from forms, websites, and other tools into Tape.
You can use this trigger for many things, including:
Saving every response from your website's contact form as a new lead.
Creating a record when a payment tool reports a new invoice.
Note:
There's no current record. A webhook isn't tied to a record, so actions like
Update recordaren't available. UseCreate recordorSearch for recordsto work with data.Keep the web address private. Anyone who knows the address can start the automation. Tape doesn't check a signature or password, and you can't reset the address. To get a new address, duplicate the automation or create a new one.
Paused automations don't run. While the automation is
PausedorBroken, Tape still accepts requests and the sender gets a success response, but no run starts. The request still shows as the last received data in the editor.
Who can use the When a webhook is received trigger?
Automations are available on the Free, Plus, and Premium Plans. The number of automation actions per month depends on your plan. Learn more about plans →
To create, edit, pause, run, or delete automations, you need to be a
Workspace adminin the workspace the database app belongs to. Only workspace admins seeAutomationsin a database app.
Set up the When a webhook is received trigger
To set up the trigger:
Open the database app and click the automations icon at the top right (
Create and view automations).Select
New automation.Select
When a webhook is receivedfrom the list of triggers.Select
Copyto copy the web address underSend webhook to:.Send a first test request to the address from your other system. Learn more about testing below →
Select
Refreshto load the data you sent.Select
Add actionand choose what should happen. Use the values you received in your actions.Select
Create automation.
What the trigger shows
Under the trigger, Tape shows a box with the web address of your automation:
Send webhook to:shows the address. Send your data to it.Copycopies the address.No webhook received yetshows until the first request arrives. After that, the box shows the data of the latest request.Variablesshows the received data as values you can insert in actions. Switch toPayloadto see the raw request.Hide webhookhides the box, andShow webhookshows it again.Refreshloads the latest request.
Each new automation gets its own address. To read the data in a larger box, select Open in fullscreen or press cmd/ctrl + enter. The address stays the same when you edit the automation. A duplicated automation gets its own new address. To duplicate an automation, click ••• next to it in the list of automations, then select Duplicate.
Use the received data
Send one test request first. Then select Refresh, and the fields of your request appear under Variables. Insert them into the fields of an action, like any other value. Learn more about values and variables →
Send a POST request with JSON, form data, or plain text. To send files, use multipart/form-data. The files are available as Webhook files, and the whole request as Webhook payload. Tape answers with status 200 and an empty response as soon as it receives the request. If the automation is Active, it runs right after.
Actions without a current record
A webhook isn't started by a record, so it has no current record. Actions that change or read "the current record" don't show up in Add action. That includes:
Update record,Delete record, andRestore recordAdd commentandGet previous valuesGet relatedandUpdate relatedCreate web linkandCall automation
Instead, create the record you need with Create record, or find it with Search for records. Then work with the collection. Learn more about collected records →
Let's look at an example
Let's say you want every contact form response to become a lead. Here's how:
Set the trigger to
When a webhook is receivedinLeads.Select
Copyand add the address to your website's form tool as its webhook.Submit a test form, then select
Refresh.Select
Add action→Create record, and choose yourLeadsapp.Insert the
NameandEmailvalues fromVariablesinto the matching fields.Select
Create automation.
The next time someone sends the form, you should see a new lead! For a full walkthrough, see Save form responses with a webhook →.
When a webhook is received errors
If
No webhook received yetdoesn't change afterRefresh, the request hasn't arrived. Check the address and the method of your other system. If the address is wrong, the sender gets an error such as401 Unauthorized. If the request says it's JSON but isn't valid JSON, the sender gets an error, too.If the status next to the automation's name shows
Brokenin red, part of the automation doesn't fit the trigger, often an action that needs a current record. The part that doesn't fit is shown in red. While the automation isBroken, it doesn't run and you can't start a manual run. Tape then showsTrigger runs manually not possible because of broken automation.If a run fails, you can see each step and its message in the automation's runs. To see the runs of an automation, click the play button next to
Manual runat the top right of the editor (View all runs), or presscmd/ctrl+1. TheRunspanel lists the runs of the last 30 days. Select a run to see each step and its message. To see the runs of all automations, selectRunsin the Automation Center.Many requests in a short time can delay automations across your organization. The delay is temporary. Tape checks the load again shortly and runs waiting automations automatically. Learn more →
Test, pause, edit, or delete an automation with this trigger
Manual runruns the automation once. ChooseLast payloadto reuse the last request it received, orCustom payloadto paste your own test data. To test the full path, send a request from your other system and selectRefresh. Learn more about testing →New automations you create in the editor are
Activeright away. The status,ActiveorPaused, sits below the automation's name in the editor. To pause one, select the status to switch it toPaused, then selectSave changes.To edit an automation, open the app, click the automations icon in the top bar, then select the automation. Select
Save changeswhen you're done.To delete an automation, open it and click
•••at the top right, then selectDelete. Confirm withDelete. You can also click•••next to the automation in the list of automations, then selectDelete. Deleting can't be undone.To switch to another trigger, hover over the trigger and click
•••to the right of it, then selectTurn intoand choose a trigger. The filter and the actions stay. If an action or a filter condition doesn't fit the new trigger, for exampleUpdate recordafter switching to a schedule, orHas changedafter switching away fromWhen a record is updated, the status next to the automation's name turns red and showsBrokenuntil you change or remove it.
Learn more
FAQs
How do I get the web address of my webhook?
How do I get the web address of my webhook?
Set up the trigger. The address appears under Send webhook to:. Select Copy to copy it.
Why can't I see the data from my other system?
Why can't I see the data from my other system?
Send a test request first, then select Refresh. Until then, the box shows No webhook received yet.
Can I use the data in my actions?
Can I use the data in my actions?
Yes! After the first request, the fields appear under Variables. Insert them like any other value.
Why can't I update the current record?
Why can't I update the current record?
A webhook isn't started by a record, so there's no current record. Use Create record, or find a record with Search for records.
What's the difference between this trigger and When a web link is clicked?
What's the difference between this trigger and When a web link is clicked?
When a webhook is received starts when another system sends data. When a web link is clicked starts when a person opens a link for a record. Learn more →
Are there other triggers I can use?
Are there other triggers I can use?
Yes! An automation can start when a record is created, updated, or deleted, when a comment is added, when a date arrives, on a schedule, and more. See every trigger in Automation triggers →
Are you a developer using the Tape API for automations?
Are you a developer using the Tape API for automations?
The automation API has its own documentation for developers. Full reference: Triggers in the developer docs →
Still have more questions? Find answers and get help from community experts in the Tape community →.
