Objective

This article shows you how to add a webhook URL rule, which matches an outgoing webhook URL and tells Twilio which webhook setting to apply to it and how much of that traffic to send.

Product

Twilio Console

Environment

Twilio Console

Procedure

1. In the Twilio Console, open Webhook configuration.
2. Select Actions, then Create rule.
3. In Webhook URL, enter the URL this rule should match.
4. In Priority rank, enter a number between 1 and 999. Lower values are evaluated first.
5. In Traffic sent, enter the percentage of matching traffic to send, from 0 to 100.
6. From Webhook setting, choose the setting whose authentication, connection, and signature configuration should apply. Its properties are shown below the field so you can confirm your choice, or leave it as None.
7. Select Create webhook URL rule. A confirmation appears and the rule is listed on the Webhook URL rules tab.

Additional Information

• You can use * as a wildcard at the end of a URL, and only one * per URL.
• Give more specific URL patterns a lower priority value so they are evaluated first. For example, https://api.example.com/failed should have a lower priority value than https://api.example.com/*.
• Priority ranks must be unique. If you enter one that is already in use, Twilio asks you to choose a different value.
• You can also create a rule as part of the guided Configure webhook flow, which adds one automatically for the URL you enter.

This content was generated by AI and reviewed, edited, and verified by a human.