CoderHelm Docs
APIWebhooks

Events from CoderHelm's relay

POST
/webhooks/relay

On a hybrid self-hosted install, where CoderHelm's hosted relay forwards the events of CoderHelm's GitHub App (and Jira app) after checking the provider's own signature. Each request is signed with the install's relay key: X-CoderHelm-Relay-Signature: t=<unix seconds>,d=<delivery id>,v1=<hex>, the HMAC-SHA256 of <t>.<d>.<raw body>. Requests older than 5 minutes are refused, and so is a delivery id the install has already taken (409). X-CoderHelm-Relay-Source is github or jira; for GitHub, X-CoderHelm-Relay-Event is GitHub's event type and the body is GitHub's payload, unchanged.

Authorization

relay_signature
headerX-CoderHelm-Relay-Signature<token>

t=<unix seconds>,d=<delivery id>,v1=<hex>: the HMAC-SHA256 of <t>.<d>.<raw body>, keyed with the install's relay key.

Header Parameters

X-CoderHelm-Relay-Signature*string

t=<unix seconds>,d=<delivery id>,v1=<hex HMAC-SHA256>.

X-CoderHelm-Relay-Source*string

Where the event came from: github or jira.

X-CoderHelm-Relay-Event?|

The provider's event type.

Request Body

The provider's payload, unchanged.

application/json
  1. body

Response Body

Handled (or acknowledged and ignored).

curl -X POST 'https://api.coderhelm.com/webhooks/relay' \  -H 'X-CoderHelm-Relay-Signature: t=1761436800,d=72d3162e-cc78-11e3-81ab-4c9367dc0958,v1=5d1a…' \  -H 'X-CoderHelm-Relay-Source: github' \  -H 'X-CoderHelm-Relay-Event: pull_request' \  -H 'Content-Type: application/json' \  -d '{}'
Empty
Edit on GitHub