Inbound Webhook

Create an inbound webhook URL and trigger GridWork pipelines from any external system that can send HTTP POST requests.

Prerequisites

• No prerequisites. Inbound webhooks are built in to GridWork.

Create an Inbound Webhook

1. In GridWork HQ, go to Settings > Integrations > Inbound Webhook.
2. Click Create Webhook.
3. GridWork generates an opaque webhook URL with a secure path token (e.g., https://gridwork.dev/api/inbound/abc123xyz).
4. Copy the URL.

What It Enables

Once created, any external system can POST JSON to your webhook URL. You can:

• Trigger pipelines from external monitoring systems or dashboards.
• Accept data from webhooks sent by third-party services.
• Use any JSON payload; GridWork passes it to the pipeline as input.
• Create multiple webhooks to organize different triggers.

Example: POST to Your Webhook

curl -X POST https://gridwork.dev/api/inbound/abc123xyz \
  -H "Content-Type: application/json" \
  -d '{"customer_id": "123", "event": "purchase"}'

The JSON payload is available to pipeline nodes as input.

Disconnect from Inbound Webhook

1. Go to Settings > Integrations > Inbound Webhook.
2. Click Delete next to the webhook URL.
3. The path token is immediately invalidated; external requests will be rejected.