Incoming Webhook Trigger
Type: Trigger
Description: Triggers a workflow when an external application sends a webhook request to a unique endpoint. This allows any external system to kick off automation flows in Ploy.
How the Incoming Webhook trigger works
The Incoming Webhook trigger provides a unique endpoint URL that you configure in an external application. When that external app sends a request to the endpoint, Ploy receives the payload and starts executing the workflow.
Any data in the webhook payload becomes available to use in child nodes throughout the workflow.
Configuration
Field | Description |
|---|---|
Endpoint | The unique URL where the external app sends the webhook payload. Copy this endpoint and configure it in your external application's webhook settings. |
Outputs
When the webhook is received, the following data becomes available for child nodes:
Output | Description |
|---|---|
Payload | The full webhook payload sent by the external application. You can reference specific fields from this payload using |
Using payload data in child nodes
After the webhook triggers the workflow, you can access data from the payload in any child node using the {{ }} syntax. For example:
{{payload.userId}}— references auserIdfield from the incoming webhook{{payload.event.type}}— references nested data within the payload
This allows you to pass specific values from the external app into actions like Slack notifications, access requests, or conditional logic.
Example use cases
Security alerts: An external security monitoring tool sends a webhook when it detects a suspicious event, triggering a workflow that notifies your security team via Slack and creates a follow-up task.
HR system integration: Your HRIS sends a webhook when an employee's role changes, triggering an access review workflow for that employee.
Custom approval flows: An internal tool sends a webhook when a request is submitted, kicking off an approval workflow with multi-step routing.
Incident response: An observability platform sends a webhook on critical alerts, triggering automated access provisioning for on-call engineers.