# Nango — Open-Source Platform for Product API Integrations

> Nango is an open-source unified API platform that handles OAuth flows, token refresh, rate limiting, and data syncing for 250+ third-party APIs so developers can ship product integrations faster.

## Install

Save in your project root:

# Nango — Open-Source Platform for Product API Integrations

## Quick Use
```bash
git clone https://github.com/NangoHQ/nango.git
cd nango
docker compose up -d
# Dashboard: http://localhost:3003
# API: http://localhost:3003/api
```

## Introduction
Nango is an open-source platform that simplifies building product integrations with third-party APIs. It handles the tedious parts of API integration: OAuth authentication, token management, rate limit handling, pagination, and continuous data synchronization, letting developers focus on business logic rather than API plumbing.

## What Nango Does
- Manages OAuth 1.0, OAuth 2.0, API key, and Basic auth flows for 250+ API providers
- Automatically refreshes expired tokens and retries failed requests with backoff
- Syncs data continuously from external APIs into your database on configurable schedules
- Handles pagination, rate limiting, and error recovery across different API patterns
- Provides a unified SDK and REST API for triggering syncs and fetching normalized data

## Architecture Overview
Nango runs as a set of Node.js services: an API server that handles auth and SDK requests, a sync worker that executes integration scripts on a schedule, and a web dashboard for configuration and monitoring. Integration scripts are written in TypeScript and define how to fetch and transform data from each provider. PostgreSQL stores connection credentials, sync state, and cached data. Redis handles job queuing for sync workers.

## Self-Hosting & Configuration
- Deploy via Docker Compose with PostgreSQL and Redis included in the default setup
- Configure provider credentials (client ID and secret) through the web dashboard or API
- Integration scripts are version-controlled TypeScript files deployed alongside Nango
- Environment variables control database URLs, encryption keys, and callback URLs
- Horizontal scaling by running multiple sync worker instances behind the job queue

## Key Features
- Pre-built OAuth support for 250+ providers including Salesforce, HubSpot, Slack, and Google
- Continuous sync engine that keeps external data fresh without manual polling code
- TypeScript integration scripts with full IDE support, type safety, and local testing
- Unified connection management UI showing all active integrations and their health status
- Webhook forwarding that normalizes incoming webhooks from different providers

## Comparison with Similar Tools
- **Merge** — Unified API as a SaaS product; closed source with per-connection pricing
- **Paragon** — Embedded integration platform; hosted only with no self-host option
- **Airbyte** — Data integration focused on warehouse loading; heavier and ELT-oriented
- **Supabase Auth** — Handles OAuth login only; does not sync external API data
- **Clerk** — Auth-only platform; does not manage ongoing API data synchronization

## FAQ
**Q: Do I need to write integration scripts from scratch?**
A: Nango includes pre-built integration templates for popular APIs. You can use them as-is or customize the TypeScript scripts to match your data model.

**Q: How does Nango handle token expiration?**
A: Nango automatically refreshes OAuth tokens before they expire and retries requests that fail due to expired credentials, with no intervention required.

**Q: Can I run Nango alongside my existing backend?**
A: Yes. Nango runs as a standalone service that your backend calls via its SDK or REST API. It does not need to be embedded into your application.

**Q: What happens if an API rate limits my sync?**
A: Nango respects rate limit headers and automatically backs off, queuing retries until the rate limit window resets. Sync progress resumes from where it left off.

## Sources
- https://github.com/NangoHQ/nango
- https://docs.nango.dev/

---
Source: https://tokrepo.com/en/workflows/0dce5c61-3f10-11f1-9bc6-00163e2b0d79
Author: AI Open Source