> ## Documentation Index
> Fetch the complete documentation index at: https://developer.vanta.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhook events

> Reference for every webhook event including payloads, schemas, and examples.

This reference documents every **event type** Vanta can deliver to a registered webhook endpoint, along with its payload schema and an example body. The payload documented for each event is the event body.

> [!NOTE]
>
> New to webhooks? Follow the step-by-step [Subscribe to webhook events](https://developer.vanta.com/docs/webhooks.md) guide to register an endpoint, verify signatures, and handle retries.

## Domains

Every event type is a stable identifier in the form `v1.<domain>.<entity>.<action>`. Events are grouped into the following domains. Browse each domain in the sidebar to see its individual events, payloads, and schemas.

| Domain | What it covers |
| - | - |
| **Questionnaire** | Questionnaire lifecycle and export events |
| **Trust Center** | Trust Center access request events |
| **Vendor** | Vendor risk decision events |
| **Information Request** | Audit information request (IRL) creation, deletion, status, comment, and evidence events |
| **Evidence** | Audit evidence lifecycle, status, and comment events |
| **Control** | Audit control comment events |

> [!NOTE]
>
> The **Information Request**, **Evidence**, and **Control** domains are auditor-specific. These events are only delivered to [Audit Partner](https://developer.vanta.com/reference/audits/overview.md) accounts during an active audit engagement. All other domains are delivered to your own Vanta account.

This catalog is exhaustive: if an event isn't listed in this reference, Vanta doesn't deliver a webhook for it. For example, access request events exist only in the **Trust Center** domain and cover requests to view your Trust Center. There are no webhook events for internal employee application access requests.

## Delivery format

Vanta sends each event as an HTTP `POST` with the event payload as the JSON body. Every delivery includes the following headers:

| Header | Description |
| - | - |
| `svix-id` | The unique message identifier. Use it to deduplicate events. |
| `svix-timestamp` | The timestamp of the message attempt (seconds since epoch). |
| `svix-signature` | The Base64-encoded signature(s), space-delimited. Use it to [verify the request](https://developer.vanta.com/docs/webhooks.md#verify-webhook-signatures) originated from Vanta. |

> [!WARNING]
>
> Treat IDs in payloads as opaque strings. To fetch the full object referenced by an event, call the corresponding [Manage Vanta API](https://developer.vanta.com/reference/manage-vanta/overview.md) endpoint with the ID from the payload.

## Retry schedule

A delivery is considered failed if your endpoint doesn't respond with a `2xx` status code within 15 seconds, including network timeouts. Vanta automatically retries failed deliveries using an exponential backoff schedule:

| Attempt | Delay after previous attempt |
| - | - |
| 1 | Immediately |
| 2 | 5 seconds |
| 3 | 5 minutes |
| 4 | 30 minutes |
| 5 | 2 hours |
| 6 | 8 hours |
| 7 | 1 day |
| 8 | 2 days |

After all retry attempts are exhausted (approximately 5 days total), the message is marked as failed. You can also manually retry failed messages from the webhook dashboard, or recover missed events as described in the [Webhooks guide](https://developer.vanta.com/docs/webhooks.md#test-your-endpoint).

## Next steps

> [card] [Set up webhooks](https://developer.vanta.com/docs/webhooks.md)
>
> Register an endpoint, verify signatures, and handle retries.

> [card] [Manage Vanta API](https://developer.vanta.com/reference/manage-vanta/overview.md)
>
> Look up the full objects referenced in webhook payloads.


## Related topics

- [Subscribe to webhook events](https://developer.vanta.com/docs/webhooks.md)
- [Vanta API changelog](https://developer.vanta.com/docs/changelog.md)
- [Create questionnaire export](https://developer.vanta.com/api-reference/customer-trust/create-questionnaire-export.md)
- [Control comment created](https://developer.vanta.com/api-reference/control/control-comment-created.md)
- [Control comment updated](https://developer.vanta.com/api-reference/control/control-comment-updated.md)
