Developers
Webhooks & event delivery
Receive signed FinanceGPT events with deterministic event IDs, payload hashes, bounded retry behavior and workspace-scoped endpoint governance.
Overview
Quickstart
API reference
Guides
LQM Builder
SDKs
Auth & webhooks
Changes
Versioning
CI
Support
Certification
Programme
Ecosystem
Solutions
References
Evidence exchange
Status
Marketplace
API plans
Verify every delivery
The signing secret is shown once when an endpoint is created or rotated.
signed_payload = X-FinanceGPT-Timestamp + "." + raw_request_body
expected = HMAC_SHA256(webhook_secret, signed_payload)
compare X-FinanceGPT-Signature with "v1=" + expected using constant-time equalityDelivery headers
X-FinanceGPT-Event— event typeX-FinanceGPT-Delivery— unique delivery identifierX-FinanceGPT-Timestamp— signing timestampX-FinanceGPT-Signature— HMAC-SHA256 signature
Retry contract
Any 2xx response is accepted. Failed deliveries use bounded retries at approximately 1, 5, 20 and 60 minutes, with at most five automatic attempts. Manual replay is available only for failed or retrying deliveries.
Event catalog
| Event | Resource | Purpose |
|---|---|---|
benchmark.updated | finance_benchmark_comparison | A published benchmarking comparison was refreshed. |
forecast.created | financial_forecast | A governed financial forecast has been generated. |
investment.report.approved | investment_client_report | An investment client report reached an approved or finalized state. |
quant.compute.completed | finance_quant_compute_job | A quantitative compute job completed and sealed its result evidence. |
test.ping | test | A developer-triggered webhook connectivity test. |
workflow.completed | finance_workflow_run | A governed FinanceGPT workflow run completed. |