Skip to main content
RECOGNITION · PROGRAMMES · ECOSYSTEM · TRUST FinanceGPT Labs
Listed on NVIDIA MarketplaceEnterprise Applications · Verify listing
Trust Center FinanceGPT applications
FinanceGPT Developers

Receive FinanceGPT events

Subscribe to the events your integration needs, verify every signed request, return a 2xx response quickly, and use delivery evidence only when something needs attention.

Event catalog JSON
Overview Quickstart APIs SDKs Models Agents & tools Resources

Subscribe → verify → acknowledge → recover

The normal path is intentionally short. Delivery operations stay out of the way until a request fails.
1 · Subscribe
Choose only needed events

Register one HTTPS endpoint for sandbox or production and select the smallest useful event set.

2 · Verify
Check the HMAC signature

Verify the timestamp plus raw request body before parsing or acting on the event.

3 · Acknowledge
Return 2xx quickly

Persist the event identifier, enqueue your own work, and acknowledge without holding the delivery open.

4 · Recover
Inspect only failed delivery

FinanceGPT retries with bounded backoff. Manual replay is available only for failed or retrying deliveries.

Verify the request before using it

Webhook signing secrets are shown once when an endpoint is created or rotated.
HMAC-SHA256
signed_payload = X-FinanceGPT-Timestamp + "." + raw_request_body
expected = HMAC_SHA256(webhook_secret, signed_payload)
constant_time_compare("v1=" + expected, X-FinanceGPT-Signature)
Required headers
  • X-FinanceGPT-Event — event type
  • X-FinanceGPT-Delivery — unique delivery identifier
  • X-FinanceGPT-Timestamp — signing timestamp
  • X-FinanceGPT-Signature — v1=<digest>
Delivery behavior

Any 2xx response is accepted. Failed deliveries use bounded retries at approximately 1, 5, 20 and 60 minutes, with at most five automatic attempts.

Use X-FinanceGPT-Delivery as your idempotency key so a retry does not repeat downstream work.

Start with one event

Add more subscriptions only after the first signed test delivery is verified.
6 events
benchmark.updatedfinance_benchmark_comparison

A published benchmarking comparison was refreshed.

forecast.createdfinancial_forecast

A governed financial forecast has been generated.

investment.report.approvedinvestment_client_report

An investment client report reached an approved or finalized state.

quant.compute.completedfinance_quant_compute_job

A quantitative compute job completed and sealed its result evidence.

test.pingtest

A developer-triggered webhook connectivity test.

workflow.completedfinance_workflow_run

A governed FinanceGPT workflow run completed.

Payload and recovery reference

Open when implementing event parsing, retries or delivery troubleshooting.
 
{
  "id": "evt_...",
  "type": "workflow.completed",
  "created_at": "2026-08-30T08:00:00Z",
  "workspace_id": "...",
  "data": { "object": { "type": "finance_workflow_run", "id": "218" } }
}

Do not infer transaction authority from an event. Webhooks communicate state changes; existing workspace permissions, approvals, policies and Financial Actions controls remain authoritative.