Webhooks
Webhooks allow you to receive real-time notifications when events occur in your Cubewire organization. Configure a URL to receive HTTP POST requests when transactions are confirmed, policies are evaluated, or other events occur.
What are Webhooks?
A webhook configuration includes:
- URL — Your endpoint to receive events
- Events — Which event types to subscribe to
- Secret — Optional signing secret for request verification
Webhook Flow
Common Use Cases
Transaction Notifications
- Receive event when transaction is confirmed
- Update internal systems on transaction status
- Trigger downstream workflows
Audit Integration
- Push audit events to your SIEM
- Sync events to data warehouse
- Real-time compliance monitoring
Operational Alerts
- Get notified of policy rejections
- Monitor approval request status
- Alert on failed transactions
Best Practices
| Practice | Description |
|---|---|
| Verify signature | Use the signing secret to verify request authenticity |
| Respond quickly | Return 2xx promptly; process asynchronously if needed |
| Handle retries | Cubewire may retry on failure; ensure idempotency |
Related Topics
- Transactions — Transaction events
- Audit Logs — Event types and structure
API Reference
For complete API documentation including endpoints, request/response examples, and code samples:
- List webhooks —
GET /api/v1/webhooks - Create webhook —
POST /api/v1/webhooks - Get webhook —
GET /api/v1/webhooks/{id} - Update webhook —
PATCH /api/v1/webhooks/{id} - Delete webhook —
DELETE /api/v1/webhooks/{id}
Webhooks
Webhooks allow you to receive real-time notifications when events occur in your Cubewire organization. Configure a URL to receive HTTP POST requests when transactions are confirmed, policies are evaluated, or other events occur.
What are Webhooks?
A webhook configuration includes:
- URL — Your endpoint to receive events
- Events — Which event types to subscribe to
- Secret — Optional signing secret for request verification
Webhook Flow
Common Use Cases
Transaction Notifications
- Receive event when transaction is confirmed
- Update internal systems on transaction status
- Trigger downstream workflows
Audit Integration
- Push audit events to your SIEM
- Sync events to data warehouse
- Real-time compliance monitoring
Operational Alerts
- Get notified of policy rejections
- Monitor approval request status
- Alert on failed transactions
Best Practices
| Practice | Description |
|---|---|
| Verify signature | Use the signing secret to verify request authenticity |
| Respond quickly | Return 2xx promptly; process asynchronously if needed |
| Handle retries | Cubewire may retry on failure; ensure idempotency |
Related Topics
- Transactions — Transaction events
- Audit Logs — Event types and structure
API Reference
For complete API documentation including endpoints, request/response examples, and code samples:
- List webhooks —
GET /api/v1/webhooks - Create webhook —
POST /api/v1/webhooks - Get webhook —
GET /api/v1/webhooks/{id} - Update webhook —
PATCH /api/v1/webhooks/{id} - Delete webhook —
DELETE /api/v1/webhooks/{id}