HTTP Request no n8n: como chamar uma API no fluxo

Aprenda a usar o nó HTTP Request do n8n: campos, autenticação por credencial, exemplo de GET e POST, importação de cURL, opções úteis e erros comuns.

Por Redação Eleven Host · @robson.direitodigital · 28 de outubro de 2026 · 7 min de leitura

O HTTP Request no n8n é o nó que faz o seu fluxo chamar uma API. Você escolhe o método, informa a URL, indica a autenticação por uma credencial e, se precisar, acrescenta parâmetros, cabeçalhos e corpo.

Este guia explica o nó campo a campo, com um exemplo de GET, outro de POST e opções úteis do nó. Ele parte do n8n já funcionando, como no guia Instalar n8n na VPS: passo a passo com Docker. O endereço https://api.exemplo.com.br/v1/pedidos é fictício e serve só de exemplo. Troque pela API que você vai usar.

Para que serve o nó HTTP Request

Segundo a documentação do n8n, o nó HTTP Request consulta dados de apps e serviços que tenham uma API REST. Em palavras simples: uma API é uma porta de conversa entre programas, e o nó é o jeito de o seu fluxo bater nessa porta e trazer a resposta (ou enviar dados) para os próximos nós.

Não confunda com o webhook. O webhook recebe: ele fica esperando um aviso de fora e dispara o fluxo, como explica o guia Webhook no n8n: como criar, testar e colocar no ar. O HTTP Request faz o contrário: o seu fluxo sai e chama o outro serviço.

Os campos principais do nó

Estes são os campos que você vai preencher nas chamadas:

• Method: o tipo de pedido. A documentação lista DELETE, GET, HEAD, OPTIONS, PATCH, POST e PUT. O GET lê dados, e o POST serve para enviar dados, mas a documentação da API que você usa diz qual método cada endereço aceita.
• URL: o endereço da API.
• Authentication: como o n8n prova quem você é para a API.
• Send Query Parameters: filtros que vão na URL, preenchidos em "Using Fields Below" ou "Using JSON".
• Send Headers: cabeçalhos do pedido, com as mesmas duas formas de preencher.
• Send Body: o corpo do pedido, com o Body Content Type: Form URLencoded, Form-Data, JSON, n8n Binary File ou Raw.

Authentication: prefira a credencial pronta

A documentação do n8n recomenda o "Predefined Credential Type", a credencial pronta, quando o serviço tem uma. Se não tem, use o "Generic Credential Type", que oferece estes tipos: Basic auth, Custom auth, Digest auth, Header auth, OAuth1 API, OAuth2 API e Query auth.

Guarde o token na credencial. Não cole o token no corpo ou nos campos do fluxo.

Passo a passo: um GET de exemplo

Vamos buscar os pedidos novos de uma API fictícia. Siga a ordem:

1. Adicione ao fluxo o gatilho que inicia o trabalho. Para rodar sozinho, veja o guia Agendar fluxo no n8n: como usar o Schedule Trigger.
2. Adicione o nó HTTP Request depois do gatilho.
3. Em Method, deixe GET.
4. Em URL, escreva https://api.exemplo.com.br/v1/pedidos.
5. Em Authentication, escolha "Generic Credential Type" e o tipo "Header auth". Crie a credencial com o nome do cabeçalho Authorization e o valor Bearer SEU_TOKEN, trocando pelo token real da sua API.
6. Ligue Send Query Parameters e acrescente o parâmetro status com o valor novo.
7. Execute o nó e confira a resposta na aba de saída.

Se a resposta veio como esperado, o nó funciona e você pode ligar o resultado aos próximos nós do fluxo.

Importar um comando cURL

Algumas documentações de API trazem exemplos em cURL, um comando de terminal que faz o pedido. O nó consegue ler esse comando: clique em "Import cURL", cole o comando e clique em Import. O n8n importa o comando para a configuração do nó.

Há dois avisos da documentação do n8n. O primeiro: a importação sobrescreve a configuração atual do nó. Por isso, nosso conselho é importar num nó novo. O segundo: os valores importados viram texto (string). Para manter números e valores verdadeiro ou falso, use a opção "Using JSON".

Enviar dados com POST

Para criar algo na API, mude o Method para POST, ligue Send Body e escolha o Body Content Type JSON. O corpo pode usar dados do nó anterior por meio de uma expressão. Por exemplo, a expressão abaixo pega o campo email do item que chegou:

{{ $json.email }}

Se o item anterior tem o campo email, o n8n troca a expressão pelo valor dele a cada item. Execute o nó e confira na saída o que a API respondeu. O código de resposta e o texto de erro, quando houver, ajudam a achar o que ajustar.

Quer um n8n para montar seus fluxos de API? O n8n Essencial sai a partir de R$ 19,90/mês; confira na loja o que cada plano inclui. Ver planos de n8n

Opções úteis do nó

Em Options, o nó tem ajustes como estes:

• Batching: manda os itens em lotes. Items per Batch define o tamanho do lote e Batch Interval a pausa entre lotes, em milissegundos.
• Timeout: o tempo de espera, em milissegundos, pelos cabeçalhos da resposta.
• Include Response Headers and Status: inclui na saída os cabeçalhos e o código de status da resposta.
• Never Error: trata a chamada como bem-sucedida mesmo quando a API devolve um código de erro. Útil para ler o erro dentro do fluxo.
• Response Format: Autodetect, File, JSON ou Text.
• Redirects: vem ligado por padrão, com o campo Max Redirects.
• Lowercase Headers: vem ligado por padrão.
• Proxy: para passar a chamada por um proxy.
• Ignore SSL Issues: baixa a resposta mesmo se o certificado falhar. Use só em teste.

Paginação

Algumas APIs devolvem os resultados em páginas. A opção Pagination tem três modos: Off, "Update a Parameter in Each Request" e "Response Contains Next URL". Nela você pode usar as variáveis $pageCount, $request e $response. A documentação recomenda conferir a documentação da API, ou fazer uma chamada sem paginação, antes de configurar essa opção.

Erros comuns e como tratar

• 401 ou 403: a API recusou a credencial. Confira o tipo de autenticação, o nome do cabeçalho e se o token está correto e dentro da validade.
• 429: você passou do limite de pedidos da API. Use o Batching para espaçar os itens, com um Batch Interval maior. Veja também o guia n8n com ChatGPT: como usar a API da OpenAI nos fluxos.
• Timeout: a API demorou para responder. Aumente o Timeout do nó e veja se a API está fora do ar.

Para falhas passageiras, as configurações do nó têm o "Retry On Fail". Segundo a documentação, ele ajuda com erro passageiro. Cuidado nosso, que não vem da documentação: repetir a chamada pode repetir o que ela faz, e um POST que cria um registro pode criar duplicados.

Precisa de um n8n para testar suas chamadas? O n8n Essencial custa a partir de R$ 19,90/mês; confira na loja o que cada plano inclui. Conhecer o n8n Essencial

Perguntas frequentes

Qual a diferença entre o HTTP Request e o Webhook no n8n?

O Webhook recebe um aviso de fora e inicia o fluxo. O HTTP Request faz o caminho inverso: o fluxo chama uma API e traz a resposta.

Como autenticar o HTTP Request?

No campo Authentication, prefira o "Predefined Credential Type" quando o serviço tem credencial pronta. Quando não tem, use o "Generic Credential Type" e escolha o tipo que a API pede, como Header auth ou OAuth2 API.

Posso colar o comando cURL da documentação da API?

Pode, com "Import cURL". A importação sobrescreve a configuração atual do nó e transforma os valores em texto. Para manter números e valores verdadeiro ou falso, use "Using JSON".

O que fazer com o erro 429 no n8n?

Ligue o Batching em Options para mandar os itens em lotes e aumente o Batch Interval. Se a API informa o tempo de espera, respeite-o.

O que faz a opção Never Error?

Ela faz o nó tratar a chamada como bem-sucedida mesmo que a API devolva um código de erro. Assim o fluxo continua e você decide o que fazer com a resposta.