Webhook Integration
Overview
Our webhook system enables real-time notifications when a new event ocurred for the company you want. This allows you to instantly receive and process updates without having to repeatedly poll our API.
Event Types
Currently, we support the following event:
clientview_updated
- Triggered when a new ClientView model is generated for the companyautotagger_finished
- Triggered when Autotagger service finishes processing new fundamentals for a company
For both events, the Webhook payload includes a series field, mapping each updated series ID to its updated periods.
Setup Instructions
To set up a webhook, you need to provide the following information:
Field | Description | Required |
---|---|---|
| The endpoint URL where webhook notifications will be sent | ✅Yes |
| Name of the authentication header (e.g., | ✅Yes |
| Optional prefix for the authentication value (e.g., | ❌No |
| Secret value for authentication | ✅Yes |
Request Format
When a webhook event is triggered, our system will send an HTTP POST request to your specified URL with the following:
Headers
Content-Type: application/json
{header_name}: {prefix} {auth_secret}
Example
- url: https://yoururl.com
- header_name: Authorization
- prefix: X-API-KEY
- auth_secret: secret_api_key
Webhook triggers a POST request to https://yoururl.com with the following headers:
Content-Type: application/json
Authorization: X-API-KEY secret_api_key
Body
Autotagger Finished
{
"event_type": "clientview_updated",
"company_id": 2,
"series": {
"SERIES_ID_1": {
"periods": [
"2025Q1"
]
},
"SERIES_ID_2": {
"periods": [
"2025Q1"
]
}
}
}
ClientView Update
{
"event_type": "autotagger_finished",
"company_id": 2,
"series": {
"SERIES_ID_3": {
"periods": [
"2025Q1"
]
},
"SERIES_ID_4": {
"periods": [
"2025Q1"
]
}
}
}
Need Help?
If you encounter any issues with webhook configuration or delivery, please contact your Sales Representative
Updated 4 days ago