What are Webhook Subscriptions

Information in our system is constantly changing, long after API calls have been made.

To stay updated on the latest details for users, nodes, subnets and transactions, we recommend subscribing to webhooks. This allows you to register a URL to receive updates as they occur.

Example Use Cases:

  • A previously verified user may be flagged for a sanctions match.

  • A node’s balance may update after a payment has posted.

  • A subnet may be locked after the user is locked for fraud.

  • A transaction may begin processing after it is created.

Webhook Retries

Synapse will send ~5 retries within a 24 hour period for any failed webhook delivery. A webhook delivery is considered a failure unless your server responds with one of the following HTTP codes: 200, 204, 400, 404, 405, 408.

After the failed attempts, we will log the webhooks. That way, even if we fail to deliver the request, you can still access the original request and the reason as to why the webhook failed.

Originating IP Address

Currently we send Webhooks from the following IP addresses:

Last updated