Overview
Toolio now supports email notifications for Data Alerts, allowing users to receive real-time email alerts when importer or integration issues occur. Previously, Data Alerts were only visible within the Toolio application itself - requiring users to log in and check the Data Alerts panel or Import History page. With this release, technical team members and stakeholders who may not be actively working in Toolio can stay informed about data pipeline issues without needing to monitor the application directly.
Subscribing to Email Notifications
Users can manage their notification subscriptions from the Settings area within Toolio:
Navigate to Settings > Organization Settings > Notifications > Subscriptions
Click to create a new subscription
Select the notification channel (Email or Webhook)
Choose which event types to subscribe to
Save the subscription
Once subscribed, the user will receive an email each time the selected alert type is triggered for their tenant.
There are also 2 methods of notification delivery (more details below):
Channel | Description |
Sends alert notifications directly to the subscribed user's email address. | |
Webhook | Sends alert payloads to a configured webhook endpoint for programmatic consumption. |
Supported Alert Event Types
The following event types are available for subscription:
Event Type | Description |
IMPORT_JOB_FAILED | Triggered when a data import does not complete successfully. |
IMPORT_JOB_MISSING | Triggered when a recent expected import is not found. (Trigger threshold configured via Missing Import Alerts) |
INTEGRATION_FAILED | Triggered when there is a connection issue with an integration (e.g., Shopify). |
IMPORT_JOB_STARTED | Triggered when a data import job begins processing. |
IMPORT_JOB_COMPLETED | Triggered when a data import job finishes processing successfully. |
IMPORT_JOB_COMPLETED_WITH_ERRORS | Triggered when a data import job finishes processing successfully, but there are unsuccessful line items from the job. |
You can simply define any email(s) you'd like to deliver notifications to in the configuration menu.
Notification emails are sent with the following subject line format:
Toolio Report: [EVENT_TYPE] Context - Error Type - Date
For example:
Toolio Report: [IMPORT_JOB_MISSING] Sale - Missing Import - 2026-01-28
The email body includes:
The alert details (event type, context, and error information)
A direct link to the Data Alerts view inside Toolio — the same view a user would see by navigating to Data Alerts within the application
Webhook
Webhook-specific config requires:
urlmust be a valid URIheadersare optional
Sample payload:
{
"eventType": "INTEGRATION_FAILED",
"payload": {
"integrationId": 123,
"integrationName": "Shopify",
"message": "Token expired",
"occurredAt": "2026-02-20T10:15:00.000Z"
}
}
If headers are configured, they are forwarded on the outbound webhook request:
{
"url": "https://hooks.example.com/toolio",
"headers": {
"Authorization": "12345",
"Tenant": "demo"
}
}