Passportal

1

Create an integration

Sign up for a free Nango account (here) if you haven’t already. Then navigate to Integrations -> Configure New Integration -> select Passportal.

2

Authorize Passportal

Go to Connections -> Add Test Connection -> Authorize, then enter your Passportal API Access Key ID, HMAC Token, Content String, and Base URL. Later, you’ll let your users do the same directly from your app.

3

Call the Passportal API

Let’s make your first request to Passportal (fetch a list of clients). Replace the placeholders below with your Nango secret key, integration ID, and connection ID:

cURL
Node

curl -X GET "https://api.nango.dev/proxy/api/v2/clients" \
  -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>" \
  -H "Accept: application/json"

Install Nango’s backend SDK: npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

// Fetch a list of clients from Passportal
const res = await nango.get({
  endpoint: '/api/v2/clients',
  providerConfigKey: '<INTEGRATION-ID>',
  connectionId: '<CONNECTION-ID>'
});

console.log(res.data);

You can also fetch credentials dynamically via the Node SDK or API.

✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Next step: Embed the auth flow in your app to let your users connect their Passportal accounts.

Topic	Links
Authorization	Guide to connect to Passportal using Connect UI
General	Passportal Website
Developer	Passportal API Documentation
	API Key Management Guide
	Create HMAC Token Guide
	Generate API Access Token

Contribute useful links by editing this page

Passportal uses instance-specific base URLs (for example, mycompany.passportalmsp.com).
Generate your HMAC Token offline before creating a connection in Nango.
When creating the connection, ensure you provide the same Content String that was used to generate the HMAC Token.

Contribute API gotchas by editing this page

API Guides

APIs & Integrations