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

# Correios

> Integrate your application with the Correios APIs

## 🚀 Quickstart

Connect to Correios with Nango and see data flow in 2 minutes.

**1. Create the integration**

In Nango ([free signup](https://app.nango.dev)), go to **Integrations** -> *Configure New Integration* -> *Correios*.

**2. Authorize Correios**

Go to **Connections** -> *Add Test Connection* -> *Authorize*, then choose the environment and enter your Meu Correios username, API access code and contract number. Nango exchanges them for a token and keeps it valid. Later, you'll let your users do the same directly from your app.

**3. Call the Correios API**

Let's make your first request to the Correios Busca CEP API to list the states and their postal code ranges (the Busca CEP service must be enabled on your contract). Replace the placeholders below with your [Environment API key](https://nango.dev/docs/reference/backend/http-api/api-keys.md), integration ID, and connection ID:

> [tab] cURL
>
> ```bash theme={null}
> curl "https://api.nango.dev/proxy/cep/v1/ufs" \
>   -H "Authorization: Bearer <NANGO-API-KEY>" \
>   -H "Provider-Config-Key: <INTEGRATION-ID>" \
>   -H "Connection-Id: <CONNECTION-ID>"
> ```

> [tab] Node
>
> Install Nango's backend SDK with `npm i @nangohq/node`. Then run:
>
> ```typescript theme={null}
> import { Nango } from '@nangohq/node';
>
> const nango = new Nango({ apiKey: '<NANGO-API-KEY>' });
>
> const res = await nango.get({
>     endpoint: '/cep/v1/ufs',
>     providerConfigKey: '<INTEGRATION-ID>',
>     connectionId: '<CONNECTION-ID>'
> });
>
> console.log(res.data);
> ```

Or fetch credentials with the [Node SDK](https://nango.dev/docs/reference/backend/backend-sdk/node.md#get-a-connection-with-credentials) or [API](https://nango.dev/docs/reference/backend/http-api/connections/get.md).

✅ You're connected! Check the **Logs** tab in Nango to inspect requests.

**4. Implement Nango in your app**

Follow our [Auth implementation guide](https://nango.dev/docs/guides/auth/auth-guide.md) to integrate Nango in your app.

## 📚 Correios integration guides

* [How do I link my account?](https://nango.dev/docs/api-integrations/correios/connect)\
  Create an API access code in Correios Web Services and find your contract number.

Official docs: [Correios Developers](https://www.correios.com.br/atendimento/developers)

## 🧩 Pre-built syncs & tools for Correios

Explore Nango-provided tools in your dashboard. Extend and customize them to fit your needs.

*No pre-built syncs or tools available yet.*

> [!TIP]
>
> Not seeing the integration you need? [Build your own](https://nango.dev/docs/guides/functions/functions-guide.md) independently.

***


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