Skip to content
HALOWERK

Datenwerk

webhook relay

Create a fixed ownership-verified receiver and separate callback/status/delete tokens. POST one technical JSON payload to submit_url with submit_token and a retry nonce; it becomes immutable and is forwarded with HMAC and a stable event ID, up to three attempts. No outbound callback before an explicit token-authenticated submission. Best-effort bounded delivery, no arbitrary relay or guaranteed arrival.

POST https://daten.halowerk.com/v1/webhook-relay

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
labelstringYesPlain technical label, no personal data or secrets.
webhook_urlstringYesFixed owned HTTPS443 receiver. Publish /.well-known/halowerk-webhook-relay.json: {version:1,purpose:"webhook-relay",method:"POST",webhook_url:<exact canonical URL>,secret_sha256:SHA256(webhook_secret)}.
webhook_secretstringYesPrivate proof preimage and HMAC signing key. Example is restricted public demo, never an account credential.
expires_in_secondsintegerNoSubmission window; accepted payload has at most10minutes of delivery attempts.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "label",
    "webhook_url",
    "webhook_secret"
  ],
  "properties": {
    "label": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Plain technical label, no personal data or secrets."
    },
    "webhook_url": {
      "type": "string",
      "maxLength": 1200,
      "description": "Fixed owned HTTPS443 receiver. Publish /.well-known/halowerk-webhook-relay.json: {version:1,purpose:\"webhook-relay\",method:\"POST\",webhook_url:<exact canonical URL>,secret_sha256:SHA256(webhook_secret)}."
    },
    "webhook_secret": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{43,128}$",
      "description": "Private proof preimage and HMAC signing key. Example is restricted public demo, never an account credential."
    },
    "expires_in_seconds": {
      "type": "integer",
      "minimum": 60,
      "maximum": 86400,
      "default": 3600,
      "description": "Submission window; accepted payload has at most10minutes of delivery attempts."
    }
  }
}

Open original schema

Published input example

{
  "label": "Synthetic callback relay",
  "webhook_url": "https://daten.halowerk.com/relay/demo-receiver",
  "webhook_secret": "halowerk-public-demo-webhook-relay-ack-only-v1-20261115",
  "expires_in_seconds": 3600
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’