---
title: "Set the URL we post events to (https, public)."
method: PUT
path: "/v1/webhooks"
---

# Set the URL we post events to (https, public).

`PUT /v1/webhooks`

## Request

- Base URL: `https://api.stratumapis.com`
- URL: `https://api.stratumapis.com/v1/webhooks`
- Auth: API key in header `X-Stratum-Key`

A new endpoint, or `"rotateSecret": true`, returns the signing secret once. Each event carries `Stratum-Signature: t=<unix>,v1=<HMAC-SHA256 of "t.body">`; answer 2xx within 10 seconds, or we retry after 1, 5 and 30 minutes, 2 and 12 hours. The same event can arrive twice: skip repeats by `id`.

## Response `200`

Saved.

## Other responses

- `400`: Not an https URL on a public address.

---

[API](https://skmtc.dev/stratumapis/apis/stratum-transactions-api.md) · [All operations](https://skmtc.dev/stratumapis/apis/stratum-transactions-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stratumapis/apis/stratum-transactions-api/revisions/4f59bdd5c909?raw)