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

# Proxy requests

> How to use the requests proxy from Nango

Use the requests proxy to make authenticated API requests to the external API.

## How to use the proxy

Make sure you have an [integration configured](https://nango.dev/docs/guides/auth/auth-guide.md#guide) in your environment, and at least one [connection](https://nango.dev/docs/guides/auth/auth-guide.md#overview) available for it.

You can use the proxy with the [Node SDK](https://nango.dev/docs/reference/backend/backend-sdk/node.md#proxy) or [REST API](https://nango.dev/docs/reference/backend/http-api/proxy/get.md):

> [tab] Node
>
> ```typescript theme={null}
> try {
>     const res = await nango.proxy({
>         method: 'POST',
>         baseUrlOverride: 'https://api.example.com',
>         endpoint: '/external-endpoint',
>         providerConfigKey: '<string>',
>         connectionId: '<string>',
>         retries: 5, // Retries with exponential backoff (optional, default 0)
>         data: {
>             id: 1,
>             colorId: 'blue',
>             selected: true
>         }
>     });
>
>     // Response was 200!
>     // See https://axios-http.com/docs/res_schema
>     console.log(res.data);
> } catch (error) {
>     // Status of response != 200
>     // See https://axios-http.com/docs/handling_errors
>     console.log(error.response.data);
>     console.log(error.response.status);
>     console.log(error.response.headers);
> }
> ```

> [tab] cURL
>
> ```bash theme={null}
> curl -X POST -H 'Content-Type: application/json' \
> -H 'Authorization: Bearer <NANGO-API-KEY>' \
> -H 'Provider-Config-Key: <INTEGRATION-ID>' \
> -H 'Connection-Id: <CONNECTION-ID>' \
> -d '{"colorId: "blue"}' \
> 'https://api.nango.dev/proxy/<API-ENDPOINT>'
> ```

## Related guides

* [Auth guide](https://nango.dev/docs/guides/auth/auth-guide.md) - create the connection used by proxy requests.
* [Node SDK reference](https://nango.dev/docs/reference/backend/backend-sdk/node.md#proxy) - proxy helper methods.
* [Proxy API reference](https://nango.dev/docs/reference/backend/http-api/proxy/get.md) - REST endpoints for proxied requests.
* [Rate limits](https://nango.dev/docs/guides/functions/rate-limits.md) - handle provider throttling.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.