When webhook received

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