Pax 8

The Pax8 integration with Hudu allows you to bring your clients' cloud subscriptions directly into Hudu, helping you track license totals, renewal dates, and subscription status alongside the rest of your documentation.

Before setting up your Pax8 integration, read our Understanding Integrations article to learn basic concepts and useful tips.

What You'll Need

  • Access to create Pax8 API credentials.
  • Admin or super-admin user role within Hudu.

At any time, you can come back to your Hudu admin area → Integrations → Pax8 to make changes to the integration.

Integration Features

Hudu's integration with Pax8 allows you to sync:

  • Companies into Hudu
    • Create client spaces in Hudu directly from Pax8 companies, or merge them into existing client spaces.
  • Subscriptions into Hudu
    • Import Pax8 subscriptions as Agreements within client spaces in Hudu, including the product name, seat quantity, billing term, status, and start and end dates. This makes it easy to track license totals and renewal dates, such as NCE expirations.

   The Pax8 integration does not create integration cards or data fields on company pages. Subscription data is available in each company's Agreements section.

What Hudu needs from Pax8

  • Client ID
  • Client Secret

Creating API Credentials in Pax8

  • Sign in to Pax8 as a user with permission to manage API credentials.
  • Navigate to the API credentials area of your Pax8 partner account.
  • Create a new set of API credentials for Hudu.
  • Copy the Client ID and Client Secret and store them securely.
    Pax8 API credentials grant full access to ordering functionality in your Pax8 account. Store them securely and do not share them in plain text.

    Visit the Pax8 Developer Platform for additional information on creating and managing Pax8 API credentials.

Enabling the Pax8 Integration

  • Integrations can be enabled at any time, during Hudu environment testing or in production.
  • Once enabled, integrations can be merged into existing documentation based on predefined rules.
  • This allows you to configure the integration upfront or connect it later as needed.
  • To enable the Pax8 integration:
    • Navigate to Hudu admin → Integrations.
    • Select Pax8 from the list.

Setting up the Integration in Hudu

Setting up the integration in Hudu

Step 1. Enter your Pax8 credentials

  • In the Pax8 Credentials section, enter the client ID.
  • Enter the client secret.
    • Once saved, the secret is hidden. To change it later, click the edit icon next to the field.
  • Click Save Credentials.
  • A Credentials saved message displays, prompting you to test the connection to continue setup.

Step 2. Test connection

  • At the top right of the integration page, click Test Connection.
  • If the connection is successful, a Connection successful message displays and the Activate and Sync button becomes clickable.
  • The Options section also appears on the Settings tab once the connection is successful.
  • If the connection is not successful, you will receive an error and will not be able to continue the setup. Review the credentials entered in Step 1, click Save Credentials, and test the connection again.

Step 3. Activate and sync

  • Click Activate and Sync to run the initial sync. This begins pulling over your Pax8 companies so they can be matched in Hudu.
  • The integration status changes to Syncing, and the Activate and Sync button is replaced by Sync Now and Pause Integration.

   Sync time varies depending on the amount of data. You can navigate away from the page while a sync is in progress and check the Logs tab for status updates.

Step 4. Choose your options

  • In the Options section, select the following if needed:
    • Do not update basic company details - Hudu will not update company address, phone, website, and sync status fields from Pax8.
  • Under Skip the following, select any data you do not want imported:
    • Inactive companies
    • Subscriptions
  • Click Save Options.
  • Click Sync Now. Once the sync completes, the Companies section appears on the Settings tab.

Step 5. Match Pax8 companies

  • Before data from Pax8 can be brought into Hudu, companies must be matched to:
    • Existing companies in Hudu, or
    • New companies you create in Hudu
  • Hudu recommends matching one company first for testing to ensure data imports correctly.
  • On the Settings tab, scroll to the Companies section.
  • Open the Unmatched tab. Use the All match types, Suggested matches, and No suggested matches filters, or the search bar, to narrow the list. Suggested matches are shown in the Match column.
  • Select the companies you want to match, then use the Bulk actions menu to choose one of the following:
    • Bulk accept/create for all - Accepts suggested matches and creates new Hudu companies for the rest
    • Change match - Matches the company to a different existing Hudu company
    • Delete matches - Removes the match
  • Companies left unmatched, and their data, will not be imported.
  • Matched companies move to the Matched tab.

Step 6. Sync now to complete setup

  • Click Sync Now to pull over data for the matched or newly created companies.
  • Re-sync any time changes are made to company matching.
  • You can review sync progress and any warnings on the Logs tab.
Why can't I click Activate and Sync?

The Activate and Sync button only becomes clickable after a successful Test Connection. Confirm your credentials are entered correctly, click Save Credentials, and then click Test Connection again.

FAQ

Getting an error when testing the connection?

Answer: A failed connection test usually means the Client ID or Client Secret is incorrect. Confirm both values were copied in full with no extra spaces and that the credentials are still active in Pax8. Save and retry Test Connection in Hudu. If the issue continues, generate a new set of credentials in Pax8.

Does Hudu make changes to my Pax8 account?

Answer: No. The integration reads data from Pax8 and does not create, edit, or delete anything in your Pax8 account.

Why don't I see cancelled subscriptions on a company's page?

Answer: The Agreements section shows active agreements by default. Switch to the All agreements view to see cancelled and expired subscriptions.

Why aren't subscriptions showing up for a company?

Answer: Subscriptions only sync for Pax8 companies that are matched to a Hudu company. Confirm the company is matched, that the Subscriptions option is not set to skip, and then re-run the integration import.

How often do integrations sync?

Answer: Native integrations automatically re-sync (update) every 3 hours. You can also use the global re-sync feature to refresh native integration syncs at any point.

Why is my integration taking a long time to finish?

Answer: If the Pax8 sync has been loading for a significant amount of time, follow the steps below:

  • Test the connection to ensure Hudu and Pax8 are communicating correctly.
  • Verify your Pax8 credentials.
  • Refresh the page (while a sync is actively running).
  • Stop the sync and restart the sync.

Notes: Active integrations sync automatically every 3 hours; manual re-syncs can be performed either within an integration's settings page or by clicking the re-sync button in the top right.

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