๐ŸšซBlocked Numbers

Blocked numbers management page

Blocked numbers let you prevent specific phone numbers from calling your tracking numbers. When a blocked number calls, it is silently rejected โ€” no ring, no charge, no call log clutter.

circle-info

Blocked numbers are available on all plans (Indie and Agency). There is no limit on how many numbers you can block.


How It Works

When someone calls your tracking number, Ring Tonic checks the block list before connecting the call. If the caller is blocked, the call is instantly rejected and logged as a blocked attempt. The caller hears nothing โ€” no ringing, no voicemail.

Blocked calls:

  • Do not appear in your call logs

  • Do not count toward your call usage

  • Are logged separately as blocked attempts (retained for 90 days)

  • Trigger a call.blocked webhook if configured


Two-Tier Block Lists

Ring Tonic supports two levels of blocking:

Level
Scope
Who can manage

Workspace

Blocks a number in the current workspace only

Any workspace member

Account

Blocks a number across all your workspaces

Workspace owner only

circle-info

The Account Block List tab only appears if you own more than one workspace. If you have a single workspace, only the workspace-level list is shown.

When a call comes in, Ring Tonic checks both lists. If the caller appears on either the workspace block list or the account block list, the call is rejected.


Blocking a Number

1

Open Blocked Numbers

Navigate to Blocked Numbers in the sidebar.

Blocked numbers page with Block Number button
2

Click Block Number

Click the Block Number button in the top-right corner.

3

Fill In the Details

  • Phone Number โ€” Enter the number to block

  • Reason โ€” Select a reason (Spam, Harassment, Wrong Number, Telemarketer, Competitor, or Other)

  • Note (optional) โ€” Add context about why you're blocking this number

  • Mark as Junk โ€” Toggle this on to automatically mark all existing pending calls from this number as Junk. Calls that have already been qualified will not be affected.

Click Block Number to confirm.

Block number dialog with phone number, reason, and note fields

Block Reasons

Reason
Description

Spam / Robocall

Automated or junk calls

Harassment

Threatening or abusive callers

Wrong Number

Persistent misdials

Telemarketer

Unwanted sales calls

Competitor

Suspected competitor calling your tracking lines

Other

Any other reason


Blocking from Call Logs

You can block a caller directly from the call logs table without navigating to the Blocked Numbers page.

  1. Find the call in your call logs

  2. Click the row actions menu (three dots)

  3. Select Block Caller

  4. The block dialog opens pre-filled with the caller's phone number

circle-check

Importing Blocked Numbers

If you have a list of numbers to block, you can import them in bulk via CSV.

1

Download the Template

Click Import CSV on the Blocked Numbers page, then click Download template to get a pre-formatted CSV file.

The template has three columns:

2

Fill In Your Numbers

  • phone_number (required) โ€” The number to block in E.164 format

  • reason (optional) โ€” One of: spam, harassment, wrong_number, telemarketer, competitor, other. Defaults to other if left blank.

  • note (optional) โ€” Free-text note, up to 500 characters

3

Upload the File

Click Import CSV, select your file, and click Import. Ring Tonic will process the file and report:

  • How many numbers were imported

  • How many duplicates were skipped

  • Any rows with errors

circle-exclamation

Exporting Blocked Numbers

You can export your blocked numbers list to Excel or CSV.

  1. On the Blocked Numbers page, click the Export button in the table toolbar

  2. Choose Export to Excel (.xlsx) or Export to CSV (.csv)

  3. The export is processed in the background โ€” you'll receive an email with a download link when it's ready

The export includes: phone number, reason, note, blocked by, and date blocked.


Viewing Blocked Call Attempts

Click any row in the blocked numbers table to open the Blocked Call Attempts panel. This shows a timeline of every call attempt from that number in the last 90 days, including:

  • Date and time of each blocked call

  • Tracking number that was called

  • Campaign associated with the tracking number

  • Caller name (if available)

  • Caller location (city and state)

  • Block list type โ€” whether the call was blocked by the workspace or account list

Blocked call attempts timeline showing recent call attempts
circle-info

Blocked call attempt records are retained for 90 days. Older records are automatically purged.


Unblocking a Number

To remove a number from the block list:

  1. Find the number in the blocked numbers table

  2. Click the Unblock button (shield icon) on the row

  3. Confirm by clicking Unblock in the confirmation dialog

The number will immediately be able to call your tracking numbers again. Future calls from that number will be processed normally and appear in your call logs.

circle-exclamation

Outbound Call Blocking

Blocked numbers also affect outbound calls made through the browser dialer. If an agent tries to dial a blocked number, the call will be prevented and an error message is shown with the block reason.


Webhooks

If you have webhooks configured, Ring Tonic fires a call.blocked event whenever a blocked call is rejected. This is useful for tracking blocked call volume in external systems.

โšกWebhookschevron-right

Common Questions

chevron-rightDoes blocking a number cost anything?hashtag

No. Blocked calls are silently rejected before the call connects, so there is no Twilio charge and no impact on your call usage.

chevron-rightWill the blocked caller hear anything?hashtag

No. The call is silently rejected. The caller will not hear ringing, a busy signal, or a voicemail greeting.

chevron-rightCan I block area codes or patterns?hashtag

Not currently. Blocking is per individual phone number. Area code and pattern-based blocking may be added in a future update.

chevron-rightWhat happens if a number is on both the workspace and account block lists?hashtag

The call is blocked either way. Unblocking from one list does not affect the other โ€” the number must be removed from both lists to allow calls through.

chevron-rightHow long are blocked call attempts stored?hashtag

Blocked call attempt records are retained for 90 days. Older records are automatically purged.

chevron-rightIs there a limit to how many numbers I can block?hashtag

No. You can block an unlimited number of phone numbers on any plan.

Last updated