Skip to contentSkip to navigationSkip to topbar
Page toolsOn this page
Looking for more inspiration?Visit the

SHAKEN/STIR Onboarding in the Twilio Console


Learn to enable SHAKEN/STIR on your outgoing calls using the Twilio Console to deliver a trust indicator on the called party's phone. To onboard, you will submit a Primary Business Profile, configure subaccounts or identities, and create a SHAKEN/STIR Trust Product to vet and verify your numbers without code. You can use this guide to send voice notifications, create self-service automation, create an outbound call center, and create transcriptions for AI or ML.

See Related reference documentation to learn more about the registration resources used in this guide.


Deliver a trusted impression on the called party's phone

deliver-a-trusted-impression-on-the-called-partys-phone page anchor

In a few clicks in the Console, you can enable SHAKEN/STIR on your outgoing calls that deliver a trust indicator on the called party's phone.

(information)

Info

You're considered a direct customer if your employees are responsible for making the calls. This includes BPOs.

You're considered an ISV (independent software vendor) if your customers are responsible for making the calls using your product.

For ISVs, there is a REST API available to allow you to pass your customer's business information directly to Twilio to get vetted so your customers can also get highest attestation under SHAKEN/STIR.

Direct customers with no subaccounts

direct-customers-with-no-subaccounts page anchor
SHAKEN/STIR onboarding for direct customers with steps: Parent Account, Primary Business Profile, Trust Product, Attestation Level.
  1. Create a Primary Business Profile in your Parent Account in the Trust Hub part of Twilio Console(link takes you to an external page) (or the legacy Console(link takes you to an external page)) and submit for vetting.
  2. Assign phone number(s) in your account to your Primary Business Profile. This associates a single identity with the phone number(s).
  3. Create a SHAKEN/STIR Trust Product in the Trust Hub (Twilio Console(link takes you to an external page) or legacy Console(link takes you to an external page)) and submit for vetting.
  4. Assign phone numbers already assigned to your Primary Business Profile identity to the SHAKEN/STIR Trust Product.

Direct customers with subaccounts

direct-customers-with-subaccounts page anchor
SHAKEN/STIR onboarding flow for ISVs with subaccounts, showing business profiles and attestation levels.
  1. Create a Primary Business Profile in your Parent Account in the Trust Hub part of Twilio Console(link takes you to an external page) (or the legacy Console(link takes you to an external page)) and submit for vetting.

  2. Create a Secondary Business Profile under your Subaccount and submit for vetting (this would be same information as your Primary since you are a direct customer)

  3. Assign phone number(s) from your Subaccount to its Secondary Business Profile. This associates a single identity with the phone number(s).

  4. Create a SHAKEN/STIR Trust Product in the Trust Hub (Twilio Console(link takes you to an external page) or legacy Console(link takes you to an external page)) for each Secondary Business Profile and submit for vetting.

    • Make sure the appropriate Subaccount is shown in the top left corner of the Console.
  5. Assign phone numbers in Subaccount already assigned to your Secondary Business Profile to the SHAKEN/STIR Trust Product

ISVs/Resellers with a single, top-level project

directions-for-2 page anchor
SHAKEN/STIR onboarding flow for ISVs with primary and secondary business profiles leading to trust products.
  1. Create a Primary Business Profile in your Parent Account in the Trust Hub part of Twilio Console(link takes you to an external page) (or the legacy Console(link takes you to an external page)) and submit for vetting.
  2. Create a Secondary Business Profile under the Primary Business Profile and submit for vetting.
  3. Assign phone number(s) from your Parent Account to the Secondary Business Profile. This associates a single identity with the phone number(s).
  4. Create a SHAKEN/STIR Trust Product in the Trust Hub (Twilio Console(link takes you to an external page) or legacy Console(link takes you to an external page)) for each Secondary Business Profile and submit for vetting.
  5. Assign phone numbers already assigned to your Secondary Business Profile to the SHAKEN/STIR Trust Product

ISVs/Resellers using subaccounts

directions-for-3 page anchor
SHAKEN/STIR onboarding flow for ISVs with subaccounts, showing business profiles and attestation levels.
  1. Create a Primary Business Profile in your Parent Account in the Trust Hub part of Twilio Console(link takes you to an external page) (or the legacy Console(link takes you to an external page)) and submit for vetting.

  2. Create a Secondary Business Profile under your Customer Subaccount and submit for vetting.

  3. Assign phone number(s) from your Customer Subaccount to its Secondary Business Profile. This associates a single identity with the phone number(s).

  4. Create a SHAKEN/STIR Trust Product in the Trust Hub (Twilio Console(link takes you to an external page) or legacy Console(link takes you to an external page)) for each Secondary Business Profile and submit for vetting.

    • Make sure the appropriate Subaccount is shown in the top left corner of the Console.
  5. Assign phone numbers already assigned to your Secondary Business Profile to the SHAKEN/STIR Trust Product

That's it. No coding required.

Learn more about Business Profiles and other Trust Products in the Trust Hub Docs.

(information)

Info

The Twilio Compliance operations team is responsible for vetting the Business Profile and the SHAKEN/STIR Trust Product. The time to vet can be between 24 to 48 hours.

(information)

Info

Twilio signs all US calls with the appropriate attestation to meet our obligations per the TRACED ACT.


Use cases for SHAKEN/STIR with Twilio Programmable Voice

use-cases-for-shakenstir-with-twilio-programmable-voice page anchor

This guide teaches the basics required for the following use cases:

Send voice notifications with Twilio Programmable Voice

send-voice-notifications-with-twilio-programmable-voice page anchor

You can use this guide to pass cryptographic identity validation at the carrier network level, guaranteeing that your time-sensitive outbound alerts are recognized as legitimate. By leveraging SHAKEN/STIR, your urgent notifications and emergency weather closures avoid automated network blocks, ensuring they bypass "Spam Likely" labels and reach your customers immediately. To learn more advanced features that you can use with voice notifications, see Voice notifications.

Create an outbound contact center with Twilio Programmable Voice

create-an-outbound-contact-center-with-twilio-programmable-voice page anchor

You can use this guide to attach full "A-level" attestation to your outbound contact center calls, proving to terminating carriers that your business owns and has the explicit right to use its phone numbers. This protocol-level verification prevents high-volume dialer traffic from being falsely flagged as spoofed robocalls, keeping your agent connection rates high and your outreach unblocked. To learn more advanced features that you can use with outbound call centers, see Voice outbound contact center.

Build a sales dialer with Twilio Programmable Voice

build-a-sales-dialer-with-twilio-programmable-voice page anchor

You can use this guide to proactively optimize your sales conversion rates by digitally signing every outbound call your representatives place. Implementing SHAKEN/STIR verifies your business's caller identity directly on the recipient's handset, giving prospects the confidence to answer your team's calls instead of dismissing them as unverified spam. To learn more advanced features that you can use with sales dialers, see Voice sales dialer.

Build AI agents with Twilio Programmable Voice

build-ai-agents-with-twilio-programmable-voice page anchor

You can use this guide to secure carrier-level authentication for your automated conversational assistants before the audio stream even begins. By utilizing SHAKEN/STIR token signing, you establish a chain of trust that differentiates your AI agents from malicious, spoofed robocallers, allowing your intelligent virtual assistants to successfully connect and interact with users in real-time. To learn more advanced features that you can use with AI agents, see Voice AI agents.


After following this guide, you can successfully submit your business profiles and phone numbers for SHAKEN/STIR verification via the Twilio Console. Once approved, your outbound calls will be signed with full legal attestation, protecting your communications from carrier spam blocking and establishing phone numbers that customers trust.


Explore the following guides to build on what you've learned in this guide:

  • Branded Calling: Display your brand's logo and name on your customers' phones to increase answer rates and build trust.
  • Voice Integrity Onboarding: Combine your verified identity with reputation monitoring tools to protect against spam tagging.