Automatic provisioning refers to creating user identities in Playvox, in addition, it includes the maintenance and removal of user identities as status or profile updates change.

Supported Features

The following provisioning features are supported:

  • Push New Users: New users created through AD FS will also be created in Playvox.
  • Push Profile Updates: Updates made to the user's profile through AD FS will be pushed to Playvox.
  • Push User Deactivation: Deactivating the user or disabling the user's access to the application through AD FS will deactivate the user in Playvox. Note: For this application, deactivating a user means keeping all of that user's data and the user's account but the user unable to sign in or doing new audits.
  • Reactivate Users: User accounts can be reactivated in the application.

The Azure AD provisioning service uses the SCIM 2.0 protocol for automatic provisioning. The service connects to the SCIM endpoint for Playvox, and uses SCIM user object schema and REST APIs to automate the provisioning and de-provisioning of users.

SCIM 2.0 Base Url follow the structure: https://yoursubdomain.playvox.com/scim/v1


Step 1: Add an unlisted (non-gallery) application to your Azure AD organization.

In addition to the choices in the Azure AD application gallery, you have the option to add a non-gallery application. You can add any application that already exists in your organization or any third-party application from a vendor who is not already part of the Azure AD gallery:

  1. Sign in to the Azure Active Directory portal using your Microsoft identity platform administrator account.
  2. Select Enterprise Applications > New application.
  3. (Optional but recommended) In the Browse Azure AD Gallery search box, enter the display name of the application.
  4. Select Create your own application. The Create your own application page appears.

5. Under What are you looking to do with your application? choose to Integrate any other application you don't find in the gallery. This option is typically used for SAML and WS-Fed applications.

Step 2: Configure provisioning

  1. Select Provisioning to open the provisioning panel for editing.

2. Enter the Playvox site tenant base URL:

SCIM 2.0 Base Url follow the structure: https://yoursubdomain.playvox.com/scim/v1

3. Add your secret token:

If you have a subscription that includes API access, you can call the API on-demand using the appropriate credentials. These exist as User ID and API Key pairs. Playvox offers a self-service API keys management process that allows you to generate the keys you need, modifying existing keys, and revoke keys to terminate access.

Please see Playvox Developers for full documentation on the Playvox API.

Copy and paste the Base64 Key generated

4. Click Test API Credentials. If the test passes, click Save.

Troubleshooting Tips

  • Initial activation of SCIM provisioning in Playvox requires reaching out Playvox Support, (support@playvox.com). Please contact our team for questions during the configuration setup.

Note: When users are deactivated in AD FS, they will be deactivated in Playvox. Users will not be able to login to the application, but their data will remain available as an ‘inactive user’. To permanently delete user data, contact Playvox Support, (support@playvox.com).

Last Edited: 15.07.20

Did this answer your question?