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
Authorize Instantly
Go to Connections -> Add Test Connection -> Authorize, then enter your Instantly credentials. Later, you’ll let your users do the same directly from your app. Call the Instantly API
Let’s make your first request to the Instantly API (fetch a list of campaigns). Replace the placeholders below with your secret key, integration ID, and connection ID:curl -X GET "https://api.nango.dev/proxy/v2/campaigns" \
-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 with npm i @nangohq/node. Then run:import { Nango } from '@nangohq/node';
const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });
const res = await nango.get({
endpoint: '/v2/campaigns',
providerConfigKey: '<INTEGRATION-ID>',
connectionId: '<CONNECTION-ID>'
});
console.log(JSON.stringify(res.data, 2, null));
- The Hypergrowth plan is required for full API access. Free accounts start with 100 API tokens for testing.
- Instantly has two API versions:
- v2 (current) - Recommended for new integrations. Uses Bearer token authentication, supports multiple API keys with granular scopes, follows REST API standards, and has no compatibility with v1.
- v1 (deprecated 2025) - Maintained for a while but not recommended for new integrations.
- Rate limit: 10 requests per second for both API versions.
- Multiple API keys can be created with different scopes for enhanced security.
