Skip to main content

Pluralsight integration

Morten Christoffersen avatar
Written by Morten Christoffersen
Updated today

Connect your Pluralsight organisation to Viio to track license usage, monitor learner activity, and optimize your technology skills development platform subscriptions.

Capabilities

  • Users: We fetch all users in your Pluralsight organisation, including their account status, team memberships, SSO status, and multi-factor authentication settings.

  • Usage: Last login activity per user to help you understand engagement levels and identify inactive accounts.

  • Plans & Licenses: License information including total license count, active learners, and team organisation structure.

  • Admin Identification: Automatically identifies and tags plan administrators for better access management visibility.

Prerequisites

  • You must have admin access to your Pluralsight organisation account.

  • Your organisation must have API access enabled.

  • You’ll need to generate a Bearer API token from your Pluralsight account.

Setup

  1. Get your Pluralsight API token

    1. Log in to your Pluralsight Developer portal.

    2. Navigate to the "Manage Keys" page

    3. Generate a new API token for integration purposes.

    4. For detailed instructions on API access, refer to the Pluralsight API documentation.

  2. Configure the integration in Viio

    1. Open Viio → Integrations and choose Pluralsight → Connect.

    2. Enter your API token when prompted (this will be stored securely as api_token).

    3. Click 'Continue', add a name & click 'Save'.

  3. Initial sync

    1. Viio will retrieve your current Pluralsight data—plan information, users, and usage statistics.

    2. The integration automatically syncs to keep your data up to date.

Troubleshooting & FAQ

Q: Why aren't all my users showing up? A: Viio fetches all users in your Pluralsight organisation. If users are missing, verify that they haven't been removed from your account (check the removedOn status in Pluralsight).

Q: What does “last activity” track? A: Last activity shows when a user last logged into their Pluralsight account. This only appears for users who have actually logged in at least once.

Q: I'm getting a configuration error during setup A: Ensure your API token is correctly entered. The error “API token is missing” indicates that the token wasn't provided or is empty. Verify you've copied the complete token from Pluralsight.

Q: How are admin users identified? A: Viio automatically queries the Pluralsight API for plan administrators and tags them with an “Admin” role. This helps you identify who has administrative privileges in your organisation.

Q: What does “billable” status mean for users? A: A user is marked as billable if they have active product IDs assigned to them in Pluralsight. This indicates they're consuming a license.

Q: How does the integration handle deleted users? A: Users who have been removed from your Pluralsight account are automatically marked as deleted in Viio, with the deletion time recorded. This helps you maintain accurate historical records.

Technical Details

API Information

  • Uses Pluralsight GraphQL API: https://api.pluralsight.com/GraphQL

  • Authentication: Bearer token-based API authentication

  • Pagination: Cursor-based navigation (100 records per page)

Data Sync

  • The integration fetches plan information first, then retrieves all users and their usage data.

  • Admin users are identified through a separate API query and tagged accordingly.

  • Active status is determined by the isOnAccount field from Pluralsight.

Resilience & Error Handling

  • Automatic retry with exponential backoff (up to 3 attempts).

  • 250 ms initial delay with jitter to prevent thundering herd.

  • Handles GraphQL client exceptions and timeout scenarios gracefully.

Security

  • API tokens are stored securely and encrypted at rest.

  • Uses Bearer token authentication for all API requests.

  • Supports SSO-enabled users and MFA-enabled accounts.

Rate Limiting

  • The integration respects Pluralsight API rate limits through built-in retry logic.

  • Uses cursor-based pagination to efficiently retrieve large datasets.

Did this answer your question?