Webhooks

Create a signed webhook subscription

Registers a public HTTPS callback for selected order events. The response reveals the signing secret once; deliveries use the Nautilinks-Signature HMAC-SHA256 header.

post/webhooks

Request

  • Base URL: https://nautilinks.co/api/v1/agent
  • URL: https://nautilinks.co/api/v1/agent/webhooks
  • Auth: HTTP bearer

Request body

urlstring uri required

Public HTTPS URL; private, loopback, and unresolved hosts are rejected.

eventsWebhookEvent[] required

Response

Created subscription and one-time secret.

oktrue required
idstring required
urlstring uri required
eventsWebhookEvent[] required
secretstring required

One-time secret; store it immediately.

signing_key_derivation'hex(sha256(secret))' required
created_atstring required

Changes

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