Skip to main content
Triggers are available for workflow applications only.
An Integration Trigger starts your workflow automatically when a specific event occurs in an external system. You subscribe to those events through an integration, then add the matching trigger to your workflow. For example, after installing a GitHub trigger integration, you can subscribe to events such as Pull Request, Push, and Issue. Subscribe to Pull Request and add its trigger, and the workflow runs whenever someone opens a pull request in the chosen repository.

​
Add and Configure an Integration Trigger

  1. On the workflow canvas, right-click and select Add Node > Start, then choose the integration trigger event you want to start the workflow. To find more integrations, search the Marketplace.
  2. Select an existing subscription or create a new one. The trigger needs a subscription to receive events.
  3. Configure any other required settings.
The output variables of an integration trigger are defined by the integration and can’t be modified.

​
Create a Subscription

A subscription is a webhook that listens for events from an external system. Each integration supports up to 10 subscriptions per workspace.
A webhook lets one system send real-time data to another. When an event occurs, the source system packages the details into an HTTP request and sends it to a URL the destination system provides.
Prerequisite: set the callback URL baseDify builds each subscription’s callback URL from the TRIGGER_URL environment variable plus an integration-specific path. The default http://localhost is unreachable by external systems, so set TRIGGER_URL to a public domain or IP they can reach, then restart Dify before creating subscriptions.
Dify supports two ways to create a subscription, depending on what the integration supports.
  • Automatic: You pick the events to subscribe to, and Dify creates the webhook in the external system for you. This requires prior authorization, through OAuth or an API key, so Dify can set it up on your behalf.
  • Manual: You create the webhook yourself using the callback URL Dify provides. No authorization needed.
  1. Select Create with OAuth > Custom.
  2. In the external system, create an OAuth application using the callback URL Dify provides.
  3. Back in Dify, enter the application’s client ID and client secret, then click Save and Authorize.
    Once saved, the same credentials can be reused for future subscriptions.
  4. Name the subscription, select the events to subscribe to, and configure any other required settings.
    Subscribe to all available events. A trigger only fires for events its subscription covers, so a broad subscription can be reused by any trigger you add later instead of creating new ones.
  5. Click Create.

​
Manage Subscriptions

Manage an integration’s subscriptions from Integrations > Trigger. Open the integration to see its subscriptions, including how many workflows use each one, and to edit or delete them.

​
Test an Integration Trigger

To test an unpublished trigger, first click Run this step or test-run the whole workflow. This puts the trigger into a listening state so it can capture subscribed events; otherwise events are ignored even when they occur.
Last modified on June 25, 2026