Webhook to API Notification

Build an integration workflow: receive a webhook from a SaaS app, map fields with Transform, POST to a notification API, and handle failures.

Goal

When an external system sends {"event": "order.created", "orderId": "123"}, Nodlyn forwards a normalized payload to your API and logs the result.

Step 1 — Webhook trigger

1. Add Webhook with path /orders and method POST.
2. Copy the webhook URL for your upstream system.

Step 2 — Transform the payload

1. Add a Transform node (or Set Fields) after the webhook.
2. Map output fields, for example:
   • source → nodlyn
   • externalId → {{body.orderId}}
   • receivedAt → {{$now}}

Use {{$var.apiUrl}} for the base URL if you store it in Global Variables.

Step 3 — HTTP Request

1. Add HTTP Request after Transform.
2. Configure:
   • URL — {{$var.apiUrl}}/notifications or your test endpoint.
   • Method — POST.
   • Body — pass through transformed JSON.
   • Headers — Content-Type: application/json plus any API key header.

Step 4 — Branch on status

1. Add a Condition node checking {{statusCode}} equals 200 (or 2xx range).
2. True branch → Log success.
3. False branch → Log error with {{responseBody}}.

Optional: add Send Email on the false branch for operator alerts.

Step 5 — Test safely

1. Run Dry Run with sample webhook body in the test panel.
2. Validate, activate, then POST a real payload to the webhook URL.
3. Check Jobs → History for the run trace and HTTP response.

Production tips

• Store API keys in global variables or secure credential fields — never hard-code in shared screenshots.
• Use correlationId in payloads for idempotent downstream APIs.
• For high volume, consider queueing or batch nodes instead of one HTTP call per event.

See also

• Webhook component reference
• HTTP Request
• Transform