Teams Direct Routing Setup

Before you start

Sign in to the Microsoft 365 admin center as a Global Administrator. You need that role to add and verify domains.
VoIP Toolbox controls the DNS zone for your Direct Routing domain. When Microsoft gives you a TXT verification value, paste it into this page while signed in so we can publish the verification record for you.

Microsoft reference: About admin roles in Microsoft 365.

Add tenant subdomain for test calls

The per-account subdomain allows VoIP Toolbox to route test calls straight into your Teams tenant. This subdomain uses the Microsoft Carrier Trunk approach, meaning you'll need to add the domain to your test tenant using PowerShell, not the Microsoft Admin portal.

Open PowerShell with the Microsoft Graph PowerShell SDK available.
Connect to the customer tenant with permissions to add domains.

Connect-MgGraph -Scopes "Domain.ReadWrite.All" -TenantId <tenant-id>

Add your Direct Routing domain to the customer tenant.

New-MgDomain -Id example-123.probeXX.voiptoolbox.net

Load the directory management module and retrieve Microsoft's TXT verification value.

Import-Module Microsoft.Graph.Identity.DirectoryManagement
(Get-MgDomainVerificationDnsRecord -DomainId example-123.probeXX.voiptoolbox.net | Where-Object {$_.RecordType -eq "Txt"}).AdditionalProperties.text

Copy the output, usually in the form MS=ms12345678, into the VoIP Toolbox form below and publish the TXT record.

Publish the Microsoft TXT verification record

After VoIP Toolbox confirms the TXT record has been published, run the Microsoft domain confirmation command.

Confirm-MgDomain -DomainId example-123.probeXX.voiptoolbox.net

When Confirm-MgDomain completes successfully, return to VoIP Toolbox and select Confirm DNS to remove the temporary TXT record.

Activate the subdomain in Teams

After the domain is verified, activate it by adding at least one Teams licensed user or resource account that uses the new subdomain, example-123.probeXX.voiptoolbox.net.

Accepted account types

User account with Office 365 E1, E3, E5, A3, or A5.
User account with Microsoft 365 E3, E5, A3, or A5.
User account with Office 365 F1 or F3, or Microsoft 365 F1 or F3.
User account with Microsoft 365 Business Basic, Standard, Premium, G3, or G5.
User account with a Microsoft Teams Shared Devices license.
Resource account with a Microsoft Teams Phone Resource Account license.

Add the derived trunk to a Teams voice route

Add the tenant's derived trunk FQDN to the voice route that should handle VoIP Toolbox test calls.

Open the Teams Admin Center.
From the left siderail, expand Voice, then select Direct Routing.
Open the Voice routes tab.
Select Add, or select an existing voice route.
In the voice route profile, under SBCs enrolled, select Add SBCs.
In the right side panel, under Add SBC as derived trunk, enter example-123.probeXX.voiptoolbox.net.
Select Add, then select Apply.

Create VoIP Toolbox Teams tests

Once the domain and voice route are ready, create Pulse checks for the Teams destinations you want to validate.

Teams users

Place scheduled test calls to direct user numbers or routing targets.

Auto attendants

Confirm main numbers answer and menu paths stay reachable.

Call queues

Monitor queue entry points and validate that Teams accepts the call.

Go to Add Assurance Endpoint.
Set SIP Target to Microsoft Teams Direct Routing.
Choose Test Call (RTP metrics are collected automatically).
Enter the Teams user, auto attendant, or call queue destination you want to test.

Update your routing domain

Your account uses the Direct Routing domain below. Only regenerate the prefix if you need a fresh domain or are recovering from a broken configuration.

Current Direct Routing domain

example-123.probeXX.voiptoolbox.net