Register a webhook

Register a webhook. Events: quote.created, swap.agreed, swap.funded, secret.revealed, swap.settled, swap.refunded, swap.half_settled (omit = all). Returns the signing secret ONCE; deliveries are POSTed with X-Hashlock-Signature: sha256=HMAC-SHA256(secret, ${timestamp}.${body}).

post/v1/webhooks

Request

  • Base URL: https://api.hashlock.markets
  • URL: https://api.hashlock.markets/v1/webhooks
  • Auth: HTTP bearer

Request body

urlstring uri required

https only. Registration rejects an address LITERAL that is non-public, but does no DNS — a hostname resolving into a private range registers fine and then fails every delivery, visible only as lastStatus. Delivery resolves and re-checks at connect time, follows no redirects, and times out after 10s.

eventsstring[]

Response

created — { webhook, secret }

object required

Changes

No recorded changes to this operation across all 1 revision of this API.