Elgato_dark/ToolJet
1
0
Fork 0
mirror of https://github.com/ToolJet/ToolJet synced 2026-04-21 21:47:17 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 7
ToolJet/docs/versioned_docs/version-3.16.0-LTS/workflows/how-to/trigger-using-webhook.md
Pratik Agrawal 8a7dc03e8a
[docs]: Add Self Hosted Tag in Workflows (#13692)
2025-08-06 11:18:04 +05:30

3.9 KiB
Raw Blame History

id title
trigger-using-webhook Trigger Workflows Using Webhooks
Self Hosted

This guide demonstrates how to trigger workflows using webhooks.

Creating a Workflow

To create a workflow follow the following steps:

  1. Navigate to the Workflows Section on the dashboard.

<img style={{marginBottom:'15px'}} className="screenshot-full" src="/img/workflows/trigger-using-webhook/workflow-section.png" alt="Navigate to Workflow Section" />

  1. Click on Create new workflow, enter a unique name for your workflow and click on + Create workflow to create the workflow.

<img style={{marginBottom:'15px'}} className="screenshot-full" src="/img/workflows/trigger-using-webhook/new-wf.png" alt="Create a new workflow" />

  1. Configure your workflow. You can refer to the workflow overview documentation to learn how you can configure a workflow.

<img style={{marginBottom:'15px'}} className="screenshot-full" src="/img/workflows/trigger-using-webhook/configure-wf.png" alt="Configure workflow" />

  1. Navigate to the Triggers section.

<img style={{marginBottom:'15px'}} className="screenshot-full" src="/img/workflows/trigger-using-webhook/trigger-section.png" alt="Webhook option on the left panel" />

  1. Click on Webhooks. By default, the webhook trigger is disabled. Toggle the switch to enable the webhook trigger. Refer to the trigger documentation for more information.

<img style={{marginBottom:'15px'}} className="screenshot-full" src="/img/workflows/trigger-using-webhook/enable-webhook.png" alt="Enable Webhook" />

  1. Add Parameters to the workflow by clicking the + Add parameter button.

<img style={{marginBottom:'15px'}} className="screenshot-full" src="/img/workflows/trigger-using-webhook/parameters.png" alt="Add parameters to your webhook" />

  1. Copy the Endpoint URL and API token.
Copy URL and API Token

Triggering a Webhook

Let's take a look at an example of triggering a webhook using Postman.

  1. Visit Postman, and click New Request.

<img style={{marginBottom:'15px'}} className="screenshot-full" src="/img/workflows/trigger-using-webhook/postman.png" alt="Postman preview"/>

  1. Select the POST Method and paste the Endpoint URL that was copied earlier.

<img style={{marginBottom:'15px'}} className="screenshot-full" src="/img/workflows/trigger-using-webhook/postman-url.png" alt="Paste URL in Postman"/>

  1. Navigate to the Authorization tab, select Bearer Token as the Auth Type, and enter the API token.

<img style={{marginBottom:'15px'}} className="screenshot-full" src="/img/workflows/trigger-using-webhook/api-token.png" alt="Enter the API Token"/>

  1. Go to the Body tab, select Raw, and enter the required parameters in JSON format.

<img style={{marginBottom:'15px'}} className="screenshot-full" src="/img/workflows/trigger-using-webhook/parameters-postman.png" alt="Enter the parameters in postman"/>

  1. Click on Send to trigger the webhook. It will fetch the response from the created workflow.

<img style={{marginBottom:'15px'}} className="screenshot-full" src="/img/workflows/trigger-using-webhook/response.png" alt="Final Response"/>

This was a basic example of how you can trigger workflows using webhooks. You can use webhooks to connect ToolJet to external applications and services for advanced use-cases and event-driven automation.

If you want to learn how to trigger workflows withing ToolJet, refer to this guide.