---
updatedAt: 2025-10-16T17:20:57.000Z
agentTools:
  projectIndex: https://docs.nmi.com/llms.txt
---

# Webhook Subscriptions

To keep you updated on the status of your application in real time, we provide **webhook event notifications**. These notifications are sent to a **registered callback URL**, ensuring seamless communication between systems.

### Register Your Callback URL

You will need to register a **callback URL** where webhook event notifications will be sent.

### Verify Webhook Signature

To ensure the authenticity and integrity of a webhook event, a secure signature is included in the `Signature` header. This signature is generated using the `HMAC-SHA256` hashing algorithm.

The signature is computed as follows:`hash_hmac('sha256', [EVENT JSON], [SUBSCRIPTION SECRET])`

Where:

* `[EVENT JSON]` is the raw JSON payload of the event (before any parsing or modification).
* `[SUBSCRIPTION SECRET]` is the secret key associated with the webhook subscription.

To verify the signature:

1. Generate your own HMAC-SHA256 hash using the received event payload and your subscription secret.
2. Compare your generated signature with the value from the `Signature` header.
   * If they match, the webhook event is authentic and has not been tampered with.
   * If they do not match, the event should be discarded as potentially unsafe.

### Webhook Delivery & Retry Policy

When events occur, our system will attempt to deliver webhook notifications to your registered callback URL with the following behavior:

#### Retry Schedule

* **Initial attempt**: Immediate delivery
* **1st retry:** 10 seconds after initial failure
* **2nd retry:** 100 seconds after first retry (\~1 minute 40 seconds)
* **3rd retry:** 1000 seconds after second retry (\~16 minutes 40 seconds)

Total delivery window is approximately 18 minutes.

#### Retry Conditions

Webhooks are retried when:

* HTTP response codes: 4xx, 5xx (except 410 Gone)
* Network timeouts (10 second timeout per attempt)
* Connection failures (5 second connection timeout)

#### Final Failure

After 3 failed delivery attempts over \~18 minutes, the webhook is marked as permanently failed and delivery stops.