Create a webhook subscription (push on new lots)

We POST matching new lots to your https endpoint as they enter the feed. Payloads are raw per-lot records, so GSA only, like /listings. Signed with HMAC-SHA256 in X-GovAuctions-Signature; the secret is returned once, at creation. Delivery is at-least-once: dedupe on lot id.

post/webhooks

Request

  • Base URL: https://govauctions.app/api/v1
  • URL: https://govauctions.app/api/v1/webhooks
  • Auth: HTTP bearer

Request body

urlstring required

Public https endpoint.

eventsstring[]
descriptionstring

Response

Created; the response carries the signing secret once

Changes

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