Skip to main content
Twilio’s SCIM Users API (used by unified_list_users / unified_get_user) is documented by Twilio as using the OAuth 2.0 Authorization Code grant, while this auth method uses Client Credentials. Client Credentials is confirmed to work for the Role and RoleAssignment APIs (unified_list_roles, unified_get_role, and the roles expand on unified_get_user); its compatibility with the SCIM Users API has not been confirmed against a live tenant.

​
Locate your Organization SID

Sign in to the Twilio Console. Open the Admin drop-down menu and click Organization > Twilio Admin. Your Organization SID (starts with OR) is shown on the Twilio Admin page.

​
Create an OAuth App

In Twilio Console, navigate to Settings > Organization settings > Organization API access and click Create OAuth application. Select the Client Credentials grant type. On the scopes step, grant the permissions this connector’s actions need: twilio/iam/roles/list (unified_list_roles, unified_get_role), twilio/iam/role-assignments/list (unified_get_user’s roles expand). Copy the generated Client ID and Client Secret.

  • Client Secret is shown only once — store it securely.

​
Linking the Account from the Hub

1

Navigate to the Hub

Use one of the three Linking Account Methods to access the Hub.
2

Fill out the fields

Fill out the following fields using details from your provider:
  • Organization SID
  • Client ID
  • Client Secret
3

Connect

  • Click Connect
  • If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider’s authorization flow.
  • Once authorization is successful, you will see a confirmation popup

If the account linking is successful, you will see the newly linked account in your Accounts page.