Documentation Index
Fetch the complete documentation index at: https://nango.dev/docs/llms.txt
Use this file to discover all available pages before exploring further.
🚀 Quickstart
🔗 Useful links
🚨 API gotchas
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. 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. 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 -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);
Next step: Embed the auth flow in your app to let your users connect their Passportal accounts.
- 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.
