Skip to main content

Webhooks & Event Streaming

||View as Markdown|

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 TopicDescriptionPayload Highlights
contract.ingestedContract OCR extraction completedcontract_id, customer_id, tcv, confidence_score
invoice.finalizedInvoice drafted and ready for dispatchinvoice_id, total_amount, tax_amount, due_date
payment.appliedPayment matched and settled to invoicepayment_id, invoice_id, cleared_amount, clearing_method
period.lockedSubledger period locked for closeperiod, legal_entity_id, locked_by, timestamp
dispute.openedAI Collections Agent detected customer objectioncustomer_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.