Introduction
The Provider API allows MSP partners to access usage data for managed organizations, including license consumption and organization status. This article explains how to integrate NordPass MSP services with your business management tools using the Provider API.
Before you start
The Provider API provides daily and monthly usage information for all MSP-managed organizations, including:
- Consumed license count and tier
- Trial status
- Not-For-Resale (NFR) flags
NordPass’ endpoints follow REST API principles and use JSON exclusively in request bodies. If required, you need to use a “Content-Type: application/json” header and form a valid JSON payload in the request body. You will receive a valid JSON response on success or error information on failure.
Here's what to do
How to generate your private key
To authenticate API requests, you must generate JWT data for your company. Follow these steps to do so:
- Open the MSP Admin Panel, and click on the "Integrations" button, located on the right side.
- Next, select the "Provider API" button and click on the "Generate Private Key" button.
- Save the data and keep it somewhere safe. Afterwards, check the box near the "I've made a copy of the above data" and click on the "Done" button.
Note: If you lose your private key, you will have to generate a new one.
How to revoke or regenerate an API key
If your private key is lost or compromised, follow these steps:
- Open the MSP Admin Panel, and click on the "Integrations" button, located on the right side.
- Next, select the "Provider API" button and click on the "Revoke Private Key".
- Once the pop-up prompt appears, select the "Revoke" button to confirm your choice.
Note: Revoking a private key immediately disables all existing integrations that use it.
Additional tips
- Store your private key securely and limit access to it.
- Revoke the key immediately if you suspect it has been compromised.