Objective
This article explains how to create a usage trigger so Twilio emails you or calls a webhook when usage for a product category reaches an amount you choose, helping you catch unexpected spend or volume early.
Product
Twilio Console
Environment
Twilio Console
User Account Permission/Role(s) Required
You need permission to view and update usage triggers. Without it, the page shows "Access is required" with the message "To view or update usage triggers, you need additional permissions. Contact your organization or account administrator."
Procedure
- In the Twilio Console, select Billing in the left sidebar.
- Select Account usage.
- Select Usage Triggers.
- Select Create usage trigger.
- Complete the trigger details:
- Usage trigger name — a name of up to 64 characters.
- Usage category — the product usage category you want notifications for.
- Trigger by measurement type — whether the threshold is measured in usage category units, usage events, or cost.
- Trigger value threshold — the value the measurement must reach or exceed.
- Recurring — Daily, Monthly, or Yearly. One notification is sent per recurring period.
- Under Notification details, choose a Notification method:
- Send an email — enter one or more addresses in Email address, separated by commas.
- Send webhook request — enter the destination in Webhook URL.
- Select Submit.
- A confirmation message names the trigger and confirms it was created, and the new trigger appears in the list.
Additional Information
- Notifications are sent a few seconds, or up to several minutes, after a threshold is exceeded.
- The trigger list shows Usage trigger name, Usage category, Trigger threshold (with current value underneath), Recurring, and Notification method.
- Email addresses must be in the format example@email.com, and webhook URLs must be in the format http(s)://acme.com/example. The form rejects other values.
- If a required field is missing, the form reads "Check the values for all required fields."
- To change or remove a trigger later, see "How do I edit or delete a usage trigger?".
This content was generated by AI and reviewed, edited, and verified by a human.