---
title: "n8n"
description: "Integre a APIBrasil em seus workflows n8n usando HTTP Request nodes. Embora o n8n seja stateless, você pode usar nossa API REST para automações poderosas."
lang: pt-BR
canonical: https://doc.apibrasil.io/mcp/automacao/n8n
markdown: https://doc.apibrasil.io/mcp/automacao/n8n.md
source: apibrasil-documentation
---

# n8n

> Integre a APIBrasil em seus workflows n8n usando HTTP Request nodes. Embora o n8n seja stateless, você pode usar nossa API REST para automações poderosas.

- **Categoria:** Automação
- **Dificuldade:** Fácil
- **Protocolo:** chama o gateway REST por HTTP
- **Atualizado em:** 14 de janeiro de 2026

## Pré-requisitos

- n8n instalado (self-hosted ou cloud)
- Conhecimento básico de workflows n8n
- Tokens da APIBrasil

## Configuração

- **Arquivo:** `HTTP Request Node Configuration`

```json
{
  "method": "POST",
  "url": "https://gateway.apibrasil.io/api/v2/cep/cep",
  "authentication": "genericCredentialType",
  "genericAuthType": "httpHeaderAuth",
  "headers": {
    "Authorization": "Bearer {{$credentials.apibrasilBearer}}",
    "DeviceToken": "{{$credentials.apibrasilDevice}}",
    "Content-Type": "application/json"
  },
  "body": {
    "cep": "={{$json.cep}}"
  }
}
```

## Passo a passo

1. **Criar Credentials no n8n** — Vá em Settings > Credentials > New e crie uma credencial do tipo 'Header Auth' com seus tokens da APIBrasil
2. **Adicionar HTTP Request node** — No seu workflow, adicione um nó HTTP Request e configure o método e URL
3. **Configurar autenticação** — Selecione as credenciais criadas e configure os headers necessários
   ```text
   Authorization: Bearer SEU_TOKEN
   DeviceToken: SEU_DEVICE_TOKEN
   Content-Type: application/json
   ```
4. **Definir body da requisição** — Configure o body com os parâmetros necessários para a API
   ```json
   {
     "cep": "={{$json.cep}}"
   }
   ```
5. **Testar o workflow** — Execute o workflow manualmente para verificar se a integração está funcionando
6. **Processar resposta** — Adicione nós subsequentes para processar os dados retornados pela APIBrasil

## Solução de problemas

- **Erro 401 Unauthorized** — Verifique se seus tokens estão corretos nas credenciais do n8n. Os tokens devem estar ativos na plataforma APIBrasil
- **Erro de CORS** — Use o endpoint correto: gateway.apibrasil.io (não o MCP server). O n8n backend não tem problemas de CORS
- **Timeout na requisição** — Aumente o timeout no nó HTTP Request para 30 segundos ou mais, especialmente para consultas que podem demorar
- **Body não está sendo enviado** — Certifique-se de que o Content-Type está configurado como application/json nos headers

## Links relacionados

- [Documentação oficial n8n](https://docs.n8n.io)
- [API REST da APIBrasil](https://doc.apibrasil.io/apis.md)
- [Outras automações](https://doc.apibrasil.io/mcp/automacao.md)
- [Templates n8n com APIBrasil](https://doc.apibrasil.io/mcp/exemplos/n8n.md)

## Ver também

- Guia MCP: [Guia MCP](https://doc.apibrasil.io/mcp.md)
- Índice da documentação: https://doc.apibrasil.io/llms.txt
- Versão HTML desta página: https://doc.apibrasil.io/mcp/automacao/n8n