09. Automation Engine/External Triggers

External Webhook Ingress

Trigger internal GN-Apex automation DAGs from external tools (such as billing gateways, GitHub, custom ERPs, or mobile apps) using secure capability webhook URLs.

EXTERNAL INTEROP
HTTP POST
Capability Ingress Gateway

Ping a unique workflow webhook endpoint to initiate multi-step automation DAGs with arbitrary JSON payloads.

Universal Webhook Ingress
POST/automation/hooks/:workflowId

External Webhook Ingress

Workflows with the WEBHOOK trigger type receive a unique capability URL. External services can dispatch standard JSON payloads to trigger the workflow:

INTEGRATIONS / ERP

Third-Party Systems

Trigger automated workflows from accounting software, warehousing systems, or external payment gateways.

PAYLOADS / JSON

Arbitrary Event Data

Incoming JSON fields automatically populate the triggerPayload namespace for downstream action nodes.

Triggering Workflows via HTTP POST

Dispatch a standard HTTP POST request to your workflow's unique ingress endpoint:

1curl -X POST 'https://gnapex.com/automation/hooks/wf_clx998877' \
2 -H 'Content-Type: application/json' \
3 -d '{
4 "customerName": "Alice Johnson",
5 "email": "alice@company.com",
6 "orderValue": 150.00,
7 "tier": "enterprise"
8 }'

Downstream Payload Mapping

All JSON keys passed in the request body are immediately available in downstream nodes using {{triggerPayload.fieldName}}:

  • {{triggerPayload.customerName}} → “Alice Johnson”
  • {{triggerPayload.orderValue}} → 150.00