adding-nango-provider-support

Configure a new Nango provider entry in providers.yaml and generate documentation.

1|1|Updated Oct 30, 2025
One-click install
npx skills add https://github.com/NangoHQ/ai-ide-prompts --skill adding-nango-provider-support
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: adding-nango-provider-support
Source: https://github.com/NangoHQ/ai-ide-prompts/tree/main/.claude/skills/adding-nango-provider-support
Command: npx skills add https://github.com/NangoHQ/ai-ide-prompts --skill adding-nango-provider-support

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill accelerates adding support for a new Nango provider by guiding you to configure the provider in providers.yaml, generate the required documentation pages (main integration page, setup guide, connect guide), and update docs.json following established patterns.

Core Features & Use Cases

  • Provider configuration: Add the provider entry to providers.yaml in alphabetical order and specify authentication and docs metadata.
  • Documentation generation: Create the main integration page and the OAuth/setup and connect guides, aligned with existing templates.
  • Docs integration: Update docs.json to surface the new provider in the APIs & Integrations catalog.
  • Use Case: Onboard a brand-new provider (e.g., Acme) with a complete docs suite and config.

Quick Start

Use this Skill to add a new provider by updating providers.yaml, then generate the main integration page, OAuth setup guide, and connect guide, and finally update docs.json.

Frequently Asked Questions about adding-nango-provider-support

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I add a new provider to Nango's integration catalog?

Add a new provider entry to `providers.yaml` in alphabetical order by slug, specifying auth_mode, credentials, setup_guide_url, and docs_connect fields. Then create the main integration page, OAuth setup guide, and connect guide documentation, and update `docs.json` to surface the provider in the APIs & Integrations catalog.

What configuration does a Nango provider entry require?

A provider entry in `providers.yaml` requires a slug in alphabetical order, auth_mode (e.g., OAuth), credential definitions, setup_guide_url pointing to documentation, and docs_connect metadata. These fields enable Nango to recognize and route integration requests to the provider.

Do I need to create documentation when adding a Nango provider?

Yes. Adding a provider requires generating three documentation pages following established templates: a main integration page, an OAuth or setup guide, and a connect guide. These pages must align with existing provider documentation patterns and be referenced in `docs.json`.

What's the correct order for provider entries in providers.yaml?

Provider entries in `providers.yaml` must be sorted alphabetically by slug to maintain consistency. This alphabetical ordering ensures the provider configuration is discoverable and follows Nango's established structure conventions.

How do I ensure a new provider integrates with Nango's documentation system?

After configuring the provider in `providers.yaml` and creating its documentation pages, update `docs.json` with the provider's metadata. This integration surfaces the provider in the APIs & Integrations catalog and makes it discoverable to users.