Hide Teams from showing to Users in the Company Directory and/or Developers in the API


Some customers create Teams for internal business use-cases, and they often do not want those Teams to be visible to Spoke Users in the Spoke App, or Developers using the Spoke API.

For instance, you may create a Team called Internal Finance Approvals Team that you do not want employees to see in the company directory. 

In another use-case, companies that use Twilio Studio to send calls to dynamic groups of Spoke Users, will often create a Team in Spoke as a placeholder, and then on-the-fly, change the Team membership, call offer rules, and other attributes of the Team in Spoke as they send calls from Twilio.

Hiding Teams allows you to create Teams that are not seen by users in the app. Developers using the Spoke API can choose if they want to return Hidden Teams in their API response.

How to hide a Team

  • Login into the Spoke Phone Account Portal
  • Go to Teams -> Manage Teams
  • Edit the Team you wish to hide
  • Turn on the switch: Hide team in Directory
  • Save changes

Effect of hiding a Team

If a Team is hidden: 

  • The Team does not show in the Spoke Phone Directory nor can be found by Spoke Users when searching the Directory in the Spoke App
  • The Team is not shown in Spoke Speedy for Twilio Flex, or returned in Spoke Speed search results
  • The Team is not returned, by default, to developers calling the Directory/GET API endpoint. Developers however can request to see hidden Teams in their API request.
  • For Administrators in the Account Portal, the Team:
    • Can still be found in searches and edited
    • Can still be used just like any other Team (have assigned members, roll over rules, etc.)
    • Can still have an extension, DID, be added to IVRs on Spoke or called from Twilio Studio


Was this article helpful?
0 out of 0 found this helpful