Form Trigger n8n: como criar formulários no fluxo

Aprenda a criar formulários com o Form Trigger do n8n: campos, Test URL e Production URL, resposta ao usuário, opções do nó, várias páginas e uso dos dados no fluxo.

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

O Form Trigger n8n é o nó que gera uma página de formulário e inicia o fluxo quando alguém envia esse formulário. Os campos preenchidos chegam como dados para os próximos nós, cada um com o nome que você definiu.

Este guia mostra para que o nó serve, como montar o formulário passo a passo, a diferença entre a Test URL e a Production URL, o que a pessoa vê depois de enviar, as opções úteis, como criar um formulário com várias páginas e como usar as respostas no fluxo. Os nomes das telas seguem a documentação do n8n.

Para que serve o Form Trigger

O nó é útil quando uma pessoa precisa entregar informações ao fluxo e você não quer montar uma página só para isso. Alguns exemplos neutros: um pedido de orçamento, uma inscrição em um evento ou um chamado interno de uma equipe. Nesses casos, o formulário coleta os dados e o fluxo decide o que fazer com eles.

O n8n gera a página do formulário. Você escolhe título, descrição e campos dentro do nó, e o endereço da página sai do próprio nó, como mostram as seções abaixo.

Para formulários com mais de uma página, existe o nó n8n Form, que aparece mais adiante. Nesse caso, o fluxo precisa começar pelo n8n Form Trigger, segundo a documentação.

Criar o formulário passo a passo

Adicione o nó n8n Form Trigger ao fluxo e preencha os parâmetros na ordem abaixo.

1. Authentication: escolha Basic Auth, n8n User Auth ou None. Com n8n User Auth, só usuários logados acessam o formulário, e há o botão Require Workflow Execute Permission.
2. Form Title: o título da página e o cabeçalho principal.
3. Form Description: o subtítulo, abaixo do cabeçalho. Aceita quebra de linha e HTML permitido.
4. Form Elements: os campos do formulário, descritos a seguir.
5. Respond When: o momento da resposta ao usuário, tratado em uma seção própria.

Os 12 tipos de campo

Em cada campo de Form Elements, o Element Type pode ser um destes:

• Checkboxes
• Custom HTML
• Date
• Dropdown
• Email
• File
• Hidden Field
• Number
• Password
• Radio Buttons
• Text
• Textarea

As propriedades de cada campo

Cada campo tem as mesmas propriedades de base:

• Field Label: o texto que a pessoa vê junto do campo.
• Field Name: o nome com que o dado sai para os próximos nós.
• Element Type: o tipo, da lista acima.
• Placeholder: o texto de exemplo dentro do campo.
• Default value: o valor que já vem preenchido.
• Required Field: marca o campo como obrigatório.

Pelo nó n8n Form, a documentação também descreve a definição dos campos em JSON, com chaves como fieldLabel, fieldName, fieldType, placeholder, defaultValue e requiredField. Conforme o tipo, entram ainda fieldOptions, multiselect, multipleFiles, acceptFileTypes e fieldValue.

O Custom HTML não aceita <script>, <style> nem <input> na documentação do nó n8n Form. Para o dado dele sair na saída do nó, é preciso preencher o Element Name.

O n8n Essencial sai a partir de R$ 19,90/mês; confira na loja o que cada plano inclui. Ver planos de n8n

Test URL e Production URL

O nó mostra dois endereços para o mesmo formulário, e cada um serve a uma fase do trabalho.

Test URL: para montar e testar

Segundo a documentação, ao montar ou testar o fluxo você usa a Test URL. O n8n registra um webhook de teste quando você seleciona Execute Step ou Execute Workflow. Com Execute Step roda só o gatilho, e com Execute Workflow roda o fluxo inteiro. Os dados enviados aparecem no editor.

Production URL: para o uso real

O n8n registra o webhook de produção quando você publica o fluxo. Antes de usar a Production URL, a documentação pede que o fluxo esteja salvo e publicado. Depois de publicado, o n8n roda o fluxo automaticamente quando um usuário envia o formulário.

Na Production URL, os dados não aparecem no editor. Para ver o que chegou, abra a aba Executions do fluxo.

Um passo a passo curto para sair do teste:

1. Monte o formulário e envie um teste pela Test URL, com Execute Workflow.
2. Confira no editor se os dados chegaram como esperado.
3. Salve e publique o fluxo.
4. Copie a Production URL e abra o formulário por ela.
5. Envie uma resposta e confira a execução na aba Executions.

O que mostrar depois do envio

O parâmetro Respond When decide quando o usuário recebe a resposta, e tem duas opções:

• Form Is Submitted: envia a resposta ao usuário assim que ele envia o formulário.
• Workflow Finishes: espera o fluxo terminar a execução antes de responder. Se o fluxo der erro, o usuário vê que o formulário não pôde ser enviado.

A primeira opção responde sem esperar o fluxo, e a segunda deixa a resposta depender do resultado do fluxo. Escolha conforme o que o seu formulário precisa dizer. Para uma página de conclusão própria, a documentação aponta o nó n8n Form com a página do tipo Form Ending, que aparece mais adiante.

Opções úteis do nó

Em Node options, a documentação lista estas opções:

• Append n8n Attribution: mostra ou esconde o aviso "Form automated with n8n".
• Button Label: o texto do botão de envio.
• Form Path: o último trecho da URL do formulário, para teste e produção. Ele troca o UUID gerado pelo n8n.
• Ignore Bots: ignora requisições de bots, como pré-visualizadores de links e rastreadores da web.
• Include User in Output: só aparece com n8n User Auth.
• Use Workflow Timezone: usa o fuso do fluxo, em vez de UTC, no submittedAt.
• Custom Form Styling: troca o estilo padrão da interface pública do formulário por CSS.

Preencher campos pela URL

A documentação descreve que parâmetros na URL preenchem campos, e isso vale só em produção: "Query parameters are only available when using the form in production mode". Caracteres especiais pedem codificação percentual. Em formulários de várias páginas, toda página recebe os mesmos parâmetros enviados à URL do n8n Form Trigger.

Formulário com várias páginas

Para dividir o formulário em etapas, use o nó n8n Form depois do Form Trigger. Você pode colocar outros nós entre as páginas, e cada nó n8n Form mostra a sua página quando recebe dados do nó anterior.

Para fechar o formulário, use o Page Type Form Ending. Segundo a documentação, ele encerra o formulário e mostra uma tela de conclusão, redireciona o usuário para uma URL ou exibe HTML ou texto próprio. Em On n8n Form Submission, as quatro opções são:

• Show Completion Screen
• Redirect to URL
• Show Text
• Return Binary File

As opções do nó n8n Form são Form Title, Form Description, Button Label, Custom Form Styling e Completion Page Title.

Ramos no fluxo

Quando o fluxo se divide em ramos que não rodam juntos, só um deles roda, e a página final é o Form Ending daquele ramo. Quando vários ramos recebem dados, por exemplo depois de um Switch, eles rodam um depois do outro, e só o Form Ending do último aparece.

Usar os dados do formulário no fluxo

Cada campo sai com o seu Field Name, e a saída inclui o carimbo submittedAt. Com n8n User Auth, a saída traz também ID, e-mail, nome e sobrenome do usuário.

Em um nó seguinte, você lê o dado por expressão. Como exemplo, para um campo cujo Field Name é email, a expressão fica:

{{ $json.email }}

Este é um exemplo montado a partir das opções documentadas; a página do n8n não mostra a expressão pronta. Alguns usos possíveis dos dados:

• Separar pedidos por tipo com o nó IF. O guia IF no n8n: como criar condições no seu fluxo mostra como.
• Avisar a equipe ou confirmar o recebimento por e-mail. O guia Enviar e-mail no n8n: como usar o nó Send Email cobre esse passo.
• Gravar cada resposta em uma tabela. Veja n8n com MySQL: como conectar e gravar dados no banco.

Quer conhecer o n8n da Eleven Host? O n8n Essencial sai a partir de R$ 19,90/mês; confira na loja o que cada plano inclui. Conhecer o n8n Essencial

Perguntas frequentes

O que é o Form Trigger no n8n?

É o nó que gera uma página de formulário e inicia o fluxo quando alguém envia. Os dados enviados passam para os próximos nós.

Qual a diferença entre Test URL e Production URL?

A Test URL serve para montar e testar, e os dados aparecem no editor. A Production URL passa a valer quando você publica o fluxo, e os dados ficam na aba Executions.

Como mudar o endereço do formulário?

Com a opção Form Path, que troca o UUID gerado pelo trecho final que você escolher, para teste e produção.

Dá para fazer um formulário com mais de uma página?

Dá. Comece pelo n8n Form Trigger e use o nó n8n Form para as outras páginas e para o Form Ending.

Como usar a resposta de um campo no fluxo?

Pelo Field Name do campo. Para um campo chamado email, a expressão de exemplo é {{ $json.email }}.