Transcend Docs
API referenceRules Automation

Ingest an inbound webhook trigger

POST
/api/v1/webhooks/{webhookId}

Send an event to a published Rules Automation webhook trigger at https://rule-automation.transcend.io or https://rule-automation.us.transcend.io. N.B. This is not a Sombra or api.transcend.io route.

Transcend validates the request, verifies the HMAC signature, and enqueues the payload for asynchronous rule evaluation and action execution (for example, a Custom Function). The caller receives an immediate acknowledgment and is not blocked waiting for action completion.

Configure the signing key, algorithm (sha256 or sha1), signature header, and optional timestamp fields in the Admin Dashboard when creating the webhook trigger. See the Rules Automation webhook guide for details.

Authorization

Webhook_Hmac_Signature
headerX-Signature-Header-Configured-Per-Rule<token>

HMAC signature authentication for Rules Automation inbound webhooks. The signature header name, algorithm, and signed-message template are configured per webhook trigger in the Admin Dashboard.

Path Parameters

webhookId*string

The webhook trigger ID (maestroRuleTriggers.id). Displayed in the Admin Dashboard when you create or view a webhook trigger on a Rules Automation rule.

Formatuuid

Header Parameters

content-type*string

Specify content-type: application/json for a JSON response from the Transcend API.

Matchapplication-json

Request Body

body*unknownapplication/json

Any JSON payload sent by the external provider — a JSON object or array. The entire request body is forwarded unchanged to the rule's action (for example, a Custom Function), so there is no fixed schema.

Response Body

Webhook accepted for asynchronous processing. Custom Function or other action execution happens after this response.

application/json
  1. response
accepted*true

Whether the webhook was accepted for asynchronous processing.

Value intrue
messageId*string

Unique message ID for tracing and deduplication.

Formatuuid
Example Request
curl -X POST 'https://multi-tenant.sombra.transcend.io/api/v1/webhooks/497f6eca-6276-4993-bfeb-53cbbbba6f08' \  -H 'content-type: string' \  -H 'Content-Type: application/json' \  -d '{  "event": "user.created",  "user": {    "id": "usr_123",    "email": "user@example.com"  },  "timestamp": "2026-06-08T16:07:14Z"}'
Example Response
{  "accepted": true,  "messageId": "550e8400-e29b-41d4-a716-446655440000"}