Background
The Repeat Call Guard feature lets users manage call frequency to prevent repeated outbound calls to the same number within a day. This protects against over-dialing and ensures compliance with customer contact policies.
Standard Behavior
Outbound calls can be made to the same destination number without restriction.
Call frequency limits depend only on the user’s dialing logic.
New Behavior (with Repeat Call Guard Enabled)
Users define active calling hours (start and end times).
Users set a maximum number of allowed call attempts per destination number (CLD).
Once the limit is reached, additional calls to that number are automatically blocked until the next day.
Counters reset daily based on the configured time window.
Note: This feature only applies to calls made through SIP connections and is configured per Outbound Voice Profile, meaning limits are tracked independently for each profile.
Pre-requisites
Before you begin, make sure you have:
Access to the Telnyx Customer Portal
An existing Outbound Voice Profile
A valid Telnyx API key
Step 1: Navigate to Outbound Voice Profiles
Log in to the Telnyx Customer Portal.
Go to Voice → Outbound Voice Profiles.
Select an existing profile or create a new one.
Step 2: Locate the Repeat Call Guard Section
You’ll find the Repeat Call Guard section below the Audio File Channel Type field on the profile configuration page at the bottom.
Step 3: Configure Repeat Call Guard
Enable the toggle to activate Repeat Call Guard.
Start Time: Define when call restrictions start in UTC.
Example:08:00End Time: Define when the restriction window ends in UTC.
Example:18:00Calls per CLD: Set how many times a single destination number can be called.
Example:3.
Step 4: Save Your Settings
Click Save to apply the configuration.
Your outbound profile will now enforce the set call limits within the defined time window.
Configure via API (Optional)
You can configure Repeat Call Guard directly through the Telnyx API.
Curl example:
curl -L -X PATCH 'https://api.telnyx.com/v2/outbound_voice_profiles/{profileID}' \ -H 'Content-Type: application/json' \ -H 'Accept: application/json' \ -H 'Authorization: Bearer KEYxxxxxxxxxxxxxxxxxxxxxxx' \ -d '{ "name": "time", "calling_window": { "start_time": "02:01", "end_time": "22:01", "calls_per_cld": 4 } }'Replace {profileID} and the Authorization key with your actual values.
Step 5: Verify the Configuration
Once saved, verify that:
The toggle shows Enabled.
The correct Start Time, End Time, and Calls per CLD values appear.
Calls exceeding the defined limit during the window are automatically blocked. A message "
Daily calling restriction to Destination Number +11234567890 exceeded D66 (code 403)" will be sent by Telnyx.
Tips for Success
Configure the timezone correctly. Times are saved in UTC, so you will have to ensure the time entered is converted from that target location's local time to UTC equivalent.
Remember that the call limit resets daily at midnight.
Disable the feature temporarily if you need unrestricted outbound dialing.