Quickstart (1/2): Access an API

Sign up for a Nango account (free, no credit card):

Go to the Integrations tab, click Configure New Integration and select the API to integrate with.

APIs have different ways to authorize requests: OAuth, API key, Basic, custom. Nango abstracts away the difficulties of working with each one.

If you don’t have one already, create a test account for the external system you want to integrate with.

On the Nango Connections tab, click Add Test Connection to test the authorization flow. Pick an integration, click Authorize and enter your test account credentials to authorize the API.

Once authorized, go to the Connections tab to see the newly created connection. The “Authorization” sub-tab contains the credentials necessary to consume the external API. These credentials are securely stored and automatically refreshed by Nango.

Let’s make an API request to the external API.

You will need to copy/paste the following values in the code snippet below:

• Nango secret key from your Environment Settings
• Integration ID from your Integrations
• Connection ID from your Connections

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

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

const res = await nango.post({
    endpoint: '/external-endpoint',
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<INTEGRATION-ID>',
    data: { "key": "value" }
});

console.log(res.data);

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

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

const res = await nango.post({
    endpoint: '/external-endpoint',
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<INTEGRATION-ID>',
    data: { "key": "value" }
});

console.log(res.data);

curl -X POST -H 'Content-Type: application/json' \
-H 'Authorization: Bearer <NANGO-SECRET-KEY>' \
-H 'Provider-Config-Key: <INTEGRATION-ID>' \
-H 'Connection-Id: <CONNECTION-ID>' \
-d '{"key: "value"}' \
'https://api.nango.dev/proxy/<API-ENDPOINT>'