# Webhook

This section provides the **Webhook** endpoints required to manage and operate the full lifecycle of resources within the ViaBlocks platform.
These endpoints are designed for secure, auditable, and scalable server-to-server integrations, and support core business operations and compliance workflows.

 - [POST /webhook](https://docs2-viablocks.viamericas.io/apis/outbound/webhook/paths/~1webhook/post.md): Registers a new webhook URL for receiving transaction status change notifications. ## Integration Guide Webhooks allow you to receive real-time HTTP POST notifications when your transactions change st
 - [DELETE /webhook](https://docs2-viablocks.viamericas.io/apis/outbound/webhook/paths/~1webhook/delete.md): Deactivates a webhook registration. ## Purpose Sets active=false for the specified webhook. The configuration is preserved and can be re-activated via PUT /webhook. ## Authentication Requires `x-clien
 - [GET /webhook](https://docs2-viablocks.viamericas.io/apis/outbound/webhook/paths/~1webhook/get.md): Retrieves webhook configurations for the authenticated partner. ## Behavior - Without webhook_id: Returns ALL webhooks for the partner (array) - With webhook_id: Returns a specific webhook configurati
 - [PUT /webhook](https://docs2-viablocks.viamericas.io/apis/outbound/webhook/paths/~1webhook/put.md): Updates the webhook configuration for the authenticated partner. ## Purpose Allows a partner to partially update their webhook configuration including the URL, subscribed events, and active status. ##
 - [GET /webhook/deliveries](https://docs2-viablocks.viamericas.io/apis/outbound/webhook/paths/~1webhook~1deliveries/get.md): Returns the delivery history for a specific webhook. ## Purpose Allows a partner to query the delivery log to troubleshoot missed notifications, verify integration, and audit delivery attempts. ## Whe
 - [POST /webhook/rotate-secret](https://docs2-viablocks.viamericas.io/apis/outbound/webhook/paths/~1webhook~1rotate-secret/post.md): Rotates the webhook signing secret for a specific webhook. ## Purpose Allows a partner to rotate their webhook_secret for security purposes. The old secret remains valid for a 24-hour grace period so
 - [POST /webhook/test](https://docs2-viablocks.viamericas.io/apis/outbound/webhook/paths/~1webhook~1test/post.md): Sends a test webhook delivery to verify connectivity and signature verification. ## Purpose Allows a partner to trigger a test delivery to their configured webhook endpoint. This verifies that the end