> ## 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.

# Contribute or request an API

> Add support for a new API to Nango

## Option 1: Request a new API (most popular)

The easiest way to add a new API is to request it from the Nango team.

If you have a shared Slack channel with Nango, send your request there. Otherwise, post in the `#request-a-new-api` channel of the [community](https://nango.dev/slack).

We'll deliver them according to the SLAs on our [pricing page](https://www.nango.dev/pricing).

## Option 2: Contribute a new API yourself

To contribute a new API, follow the steps below and check out past [PRs](https://github.com/NangoHQ/nango/pulls?q=is%3Apr+is%3Aclosed) starting with `feat(integrations)` for examples.

### Pre-requisites

* You have access to a test account for the API
* The API is publicly accessible
* The API is of type HTTP or SOAP

Nango supports all authorization types (OAuth, API key, basic), including custom ones.

### Add an API configuration

Fork the [repo](https://github.com/NangoHQ/nango) and edit the API configurations file ([providers.yaml](https://nango.dev/providers-yaml)). See the [API configuration reference](/integrations/api-configuration) for the available fields.

You can test the configuration of your new provider with this command:

```sh theme={null}
npx tsx scripts/validation/providers/validate.ts
```

### Test the API

To test your new provider, go to the `nango` repo root and run:

```bash theme={null}
docker compose up
```

<Tip>
  You can modify the ports in the `docker-compose.yaml` file if there are conflicts with
  other local services on your host machine.
</Tip>

When you are ready to test your API:

**Create an integration**

Open the [local Nango UI](http://localhost:3003) in your browser and add a new integration with your freshly added API.

**Create a connection**

Create a new connection for this API in the Nango UI, completing the authorization flow.

**Verify the connection**

If all goes well, you should see your new connection in the *Connections* tab. Check the connection details and make sure that the credentials are valid.

### Document the API

Add a `<api>.mdx` file (e.g. `github.mdx`) for your API to the `docs/integrations/all` folder. Check out [other examples](/integrations/overview) to fill out the content of the documentation page.

Reference the page in the `docs/docs.json` file in the `800+ APIs & Integrations` group in alphabetical order.

### Submit a pull request

Verify your contribution against [examples of past contributions](https://github.com/NangoHQ/nango/pulls?q=is%3Apr+is%3Amerged+label%3Aapi+).

Submit a pull request with the new provider to the Nango repo. Please thoroughly test the integration!

Thanks a lot for your contribution!! ❤️

<Tip>
  **Questions, problems, feedback?** Please reach out in the [Slack community](https://nango.dev/slack).
</Tip>