Skip to main content

Webhooks

Webhooks let external systems send events to ORQO over HTTP. Any system that can make an HTTP POST request can integrate with ORQO via webhooks.

Inbound Webhooks​

Each App has a unique webhook endpoint:

POST /api/v1/webhooks/:app_id

When ORQO receives a webhook:

  1. The request signature is verified against the App's configured secret.
  2. The payload is parsed according to the App's adapter.
  3. The message is routed to the appropriate handler — either a waiting agent or Doorkeeper.

Signature Verification​

Webhook requests are verified using the signing secret configured on the App. This ensures that only legitimate requests from the expected platform are processed. Requests with invalid signatures are rejected.

External Triggers​

For triggering workflows programmatically (without an App), use the API trigger endpoint instead:

POST /api/v1/trigger

See API for details.