---
sidebar_position: 9
title: Webhooks & Event Streaming
description: Real-time event streams and HMAC-signed webhooks for contract events, invoice settlements, dunning updates, and period locks.
keywords:
  - webhooks
  - event streaming
  - HMAC verification
  - financial webhooks
---

# Webhooks & Event Streaming

**Webhooks & Event Streaming in GAAPx** provides real-time event notifications for programmatic workflows, data lake ingestion, and custom ERP synchronizations.

:::info SCREENSHOT PLACEHOLDER: Webhook Endpoint Manager
**Location in App**: `App > Settings > Developers > Webhooks`  
**Visual Description**: Webhook endpoint dashboard showing endpoint URL, active subscribed events, HMAC signing secret, and delivery logs with retry history.  
**Recommended Dimensions**: `1200 x 675`  
:::

---

## Core Supported Webhook Events

| Event Topic | Description | Payload Highlights |
| :--- | :--- | :--- |
| `contract.ingested` | Contract OCR extraction completed | `contract_id`, `customer_id`, `tcv`, `confidence_score` |
| `invoice.finalized` | Invoice drafted and ready for dispatch | `invoice_id`, `total_amount`, `tax_amount`, `due_date` |
| `payment.applied` | Payment matched and settled to invoice | `payment_id`, `invoice_id`, `cleared_amount`, `clearing_method` |
| `period.locked` | Subledger period locked for close | `period`, `legal_entity_id`, `locked_by`, `timestamp` |
| `dispute.opened` | AI Collections Agent detected customer objection | `customer_id`, `invoice_id`, `dispute_reason`, `thread_url` |

---

## Security & Signature Verification

Every outbound webhook payload includes a cryptographic HMAC-SHA256 signature in the `X-GAAPx-Signature` header computed using your endpoint's shared secret.