THIS WEEK The Essential Guide to URL Management Read this week's article →
All API references

Webhooks

Receive signed events from GoTo.now through a durable delivery queue.

Outbound HTTPS delivery Webhook signing secret

Configure delivery

Open Dashboard → Settings → Webhooks, add a public HTTPS endpoint, choose its events, and copy the signing secret once. Private, local, and non-HTTPS destinations are rejected. Settings also provides test delivery, history, replay, failure state, and secret rotation.

Available events include link.created, link.updated, link.deleted, link.milestone, conversion.created, referral.activated, and workspace.member_joined; test deliveries use webhook.test.

Verify the signature

GoTo.now serializes the JSON body exactly as delivered and computes a hexadecimal HMAC-SHA256 with your secret. The request sends X-GoTo-Signature: sha256=... and a stable X-GoTo-Delivery identifier. Compute the HMAC over the raw request bytes—not parsed and re-serialized JSON—and compare signatures with a constant-time function.

Return a 2xx response promptly. Failed deliveries are retried; use the delivery identifier to make your consumer idempotent.


Return to all API references