# When webhook received

> Part of the NocoDB documentation (Workflows > Workflows > Nodes > Trigger). Index of all pages: https://nocodb.com/llms.txt. Any docs page is available as Markdown by adding `.md` to its URL.

URL: https://nocodb.com/docs/workflows/nodes/trigger-nodes/webhook
Last updated: 2026-09-25

Learn how to start a NocoDB workflow from an incoming HTTP request.

<Callout type="info">
  Available on NocoDB Cloud (Plus plan and above) and licensed on-premise deployments.
</Callout>

Starts a workflow when an HTTP request arrives at a URL that belongs to the workflow. Use it to start automations from systems that can call out over HTTP but have no dedicated NocoDB integration.

The node needs no configuration. Its webhook URL is generated once the node is configured, and requests to it start the workflow only while the workflow is published. `GET`, `POST`, `PUT`, `PATCH`, and `DELETE` are accepted.

### Testing

The trigger's test step listens for a real request. Send a request to the webhook URL while it is listening, and the trigger captures that request as its sample data. A request captured this way is only recorded as the sample: it does not run the rest of the workflow.

### Output

The trigger passes the request to the rest of the workflow:

* `request.body` — the request body, as JSON
* `request.headers` — the request headers
* `request.query` — the URL query parameters
* `request.method` — the HTTP method of the request
* `trigger.type` and `trigger.timestamp` — how and when the workflow started

Once a test request has been captured, the individual fields inside the body, headers, and query parameters can be picked one by one in later nodes, instead of only the whole object.

### Use cases

* Start a workflow from an external service's outgoing webhook
* Let a script or a scheduled job elsewhere kick off a NocoDB automation
* Receive a payload from a form or payment provider and write it into a table

***

---

## Related pages

- [Manual](https://nocodb.com/docs/workflows/nodes/trigger-nodes/manual.md): Learn how to use the Manual Trigger node in NocoDB workflows.
- [Button clicked](https://nocodb.com/docs/workflows/nodes/trigger-nodes/button-clicked.md): Start a workflow when a user clicks a Run automation button on an interface page or record.
- [Scheduled](https://nocodb.com/docs/workflows/nodes/trigger-nodes/scheduled.md): Learn how to run workflows on a fixed schedule in NocoDB.
- [Record Created](https://nocodb.com/docs/workflows/nodes/trigger-nodes/record-created.md): Trigger workflows when new records are created in NocoDB.
- [Record Updated](https://nocodb.com/docs/workflows/nodes/trigger-nodes/record-updated.md): Trigger workflows when records are updated in NocoDB.
- [Record Deleted](https://nocodb.com/docs/workflows/nodes/trigger-nodes/record-deleted.md): Trigger workflows when records are deleted in NocoDB.
- [Record Matches Condition](https://nocodb.com/docs/workflows/nodes/trigger-nodes/record-matches-condition.md): Trigger workflows when records meet specific conditions in NocoDB.
- [Record Created via Specific Form](https://nocodb.com/docs/workflows/nodes/trigger-nodes/record-created-form.md): Trigger workflows when new records are created via a specific form in NocoDB.