Skip to main content
Register a URL and Rally sends it a POST whenever one of the events you chose happens. Set endpoints up under Settings → Webhooks, or with the REST API (POST /v1/webhooks with url and events, scope webhooks:manage). When you create an endpoint, Rally shows its signing secret once. Store it; you need it to verify deliveries.

Events

The delivery

data is the record the event is about, in the same shape the app and API use. Two headers come with it:

Verifying a delivery

Compute the HMAC over the timestamp, a dot and the raw request body, and compare it to v1. Reject deliveries whose timestamp is more than a few minutes old.
Verify against the raw body exactly as received; re-serialising the JSON changes the bytes.

Retries

Respond with any 2xx within a few seconds. Anything else, or a timeout, is retried with growing gaps (about 1, 2, 4, 8 and 16 minutes) for up to six attempts, then marked failed. Deliveries and their status are listed per endpoint under Settings → Webhooks. Handlers should be idempotent: the same delivery id can arrive more than once.