Webhook Notifications
By default, automated email alerts are sent directly to company Admins and Super Admins when account usage reaches 80%, 90%, 100%, and 150% of the contracted capacity.
If your team needs to move beyond email notifications and enable system-level automated actions, you can leverage Webhooks. Webhooks seamlessly integrate resource consumption tracking directly into your internal dashboards and reporting tools, helping you proactively forecast usage and plan account upgrades well in advance.
What is a Webhook?
Think of a Webhook as an automated system-to-system message. Instead of sending a human-readable email, it transmits structured data directly to a target application the moment a limit is reached.
Configuring the Usage Limit Webhook
Webhook configuration is handled via a standard API request within the platform's developer tools.
Gather Required Prerequisites: Obtain your Personal Access Token, Organization ID, and the destination Endpoint URL that will receive the payload.
Access the GraphQL Playground: Open the API execution tool and set your authentication header:
"Authorization": "Bearer YOUR_TOKEN_HERE"
Execute the Webhook Creation Mutation: Paste the snippet below into the query panel, replacing 123456 with your actual Organization ID and inserting your target URL:
GraphQL
mutation {
createOrganizationWebhook(input: {
actions: ["usage.threshold_reached"],
name: "Usage Limit Alert",
organization_id: 123456,
url: "https://your-endpoint.com/notifications"
}) {
webhook {
id
actions
url
}
}
}
Webhook Data Payload Structure
When triggered, your endpoint will receive a JSON payload containing the following data:
JSON
{
"data": {
"action": "usage.threshold_reached",
"resource": "automation",
"threshold": 80,
"usage": {
"consumed": 1850,
"limit": 2000,
"percentage": 92.5
},
"period": {
"resets_at": "2026-10-01"
}
}
}
resource: The resource reaching its capacity.
threshold: The usage threshold percentage triggered (80, 90, 100, or 150).
consumed / limit: Current usage volume vs. total allocated capacity.
resets_at: Monthly billing cycle renewal date (UTC).
Important: Retroactive Notifications for the Current Month
If your organization reaches a usage threshold (such as 80%) and you register the Webhook after that event within the same month, please note:
Retroactive Delivery: The system automatically detects that your account has already crossed the threshold and immediately triggers the Webhook notification upon registration.
First Cycle Only: This applies solely to ensure your system captures the current month's status upon setup. In subsequent months, notifications will trigger in real time as each threshold is reached.
Advanced Technical Documentation
For additional details on updating, listing, or deleting organization webhooks and exploring other available events, refer to the Organization Webhooks Technical Documentation.
Email Notifications (Default Option)
Each alert details the impacted resource, current usage volume, overall billing cycle limit, and scheduled reset date.
Recommended Action: Use these alerts proactively to optimize workflows, pause unnecessary automations, or upgrade your plan.
How to Disable Email Notifications
If you prefer not to receive email alerts (for example, if you have already configured a webhook), you can disable them at any time:
Navigate to the User Notifications page
Locate the Usage Limits section.
Uncheck the box (flag) for the specific add-on or resource you no longer wish to receive email notifications for.
Click Save to confirm your changes.
