Configure an Integration

Guide to configure an integration in Nango.

1. Create an account

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

2. Create an integration

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

Each API has a dedicated Nango documentation page with useful links, gotchas, etc.

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

⚠️ Required for OAuth APIs

OAuth APIs require you to register your OAuth application on their developer portal.

When registering, the API provider will prompt you for the Callback URL. Use the URL displayed in the Nango integration settings. Remember to register the required scopes in the Nango integration settings and, if necessary, with the API provider.

Collect your OAuth app’s Client ID and Client Secret from the API portal and input them in your Nango integration settings.

3. Test the authorization

If you don’t have one already, create a test account for the external API 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” tab contains the credentials necessary to consume the external API. These credentials are securely stored and automatically refreshed by Nango.

Questions, problems, feedback? Please reach out in the Slack community.