Webhooks Guide
Receive real-time notifications for platform events
Webhooks allow Milemarker to push real-time updates to your systems when events occur. Instead of polling the API for changes, configure webhook endpoints to receive instant notifications about new documents, data updates, and other important events.
document.uploaded
Triggered when a new document is uploaded to a client's vault.
account.updated
Triggered when account data is refreshed with new positions or balances.
client.created
Triggered when a new client is added to the system.
transaction.posted
Triggered when new transactions are received from custodians.
sync.failed
Triggered when a data sync with a custodian encounters an error.
{
"event": "document.uploaded",
"timestamp": "2025-01-23T14:30:00Z",
"data": {
"document_id": "doc_abc123",
"client_id": "cli_xyz789",
"filename": "Q4_2024_Statement.pdf",
"category": "statements",
"uploaded_by": "system"
},
"webhook_id": "wh_def456"
}
Navigate to Settings
Go to Settings > Developer > Webhooks in your Milemarker dashboard.
Add Endpoint URL
Enter the HTTPS URL where you want to receive webhook payloads. Must be publicly accessible.
Select Events
Choose which events should trigger notifications to your endpoint.
Save & Test
Save your configuration and use the "Send Test" button to verify connectivity.
All webhook payloads include a signature header for verification:
X-Milemarker-Signature: sha256=abc123def456...
Verify the signature using your webhook secret to ensure requests originate from Milemarker.
Failed deliveries are retried with exponential backoff: 1 min, 5 min, 30 min, 2 hours, 24 hours. After 5 failures, the webhook is disabled.