Base de Conhecimento

Airtable no n8n: automatize bases e tabelas

  • airtable, n8n, automação, integração, banco de dados, workflow
  • Usuários acharam útil: 0

Crie o token de acesso, a credencial no n8n e teste uma leitura. Depois grave registros, monte o Airtable Trigger com o campo de data certo e confira erros e limites.

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

Arte da Eleven Host: janela de terminal com o título: Airtable no n8n: automatize bases e tabelas

Capa da Redação Eleven Host para o tutorial: Airtable no n8n: automatize bases e tabelas Arte: Eleven Host

Usar airtable no n8n é ligar o fluxo às suas bases: o nó Airtable lê, grava, atualiza e apaga registros das tabelas, e o Airtable Trigger inicia o workflow quando um registro novo ou alterado aparece. Assim, cadastros e tarefas deixam de ser copiados à mão.

No Airtable Trigger, troque a autenticação padrão "API Key" por Access Token, porque o Airtable desligou as API keys em 01/02/2024.

Atualizado em 16/11/2026. Em 16/11/2026, a versão estável do n8n na página de lançamentos do projeto é a 2.47.7, publicada em 13/11/2026.

O que é o Airtable e o que o n8n oferece

O Airtable organiza dados em bases. Cada base tem tabelas, e cada tabela tem campos, registros e visões (views).

O n8n tem dois nós para isso. O Airtable serve para ler, atualizar, gravar e apagar dados. O Airtable Trigger inicia o workflow quando ocorrem eventos no Airtable. Se faltar uma operação, o nó HTTP Request chama a API do serviço e pode reaproveitar a credencial do Airtable.

Para quem serve

Serve a quem já roda o n8n na própria VPS e guarda cadastros, pedidos ou tarefas em bases do Airtable. Se a VPS ainda não existe, veja o que é um servidor VPS.

VPS fazem parte do catálogo da Eleven Host. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS

Passo 1: criar o token no Airtable

O Airtable desligou as API keys em 01/02/2024. Hoje a porta de entrada é o Personal Access Token (PAT), que o n8n recomenda, ou o OAuth2. Aqui o caminho é o token.

  1. Abra a página de tokens do Airtable (airtable.com/create/tokens) e clique em Create token.
  2. Dê um nome, como n8n credential, marque os escopos e escolha o acesso às bases.
  3. Clique em Create token de novo e copie o valor.

O segredo aparece só uma vez, na criação. Copie-o antes de fechar a janela.

Escopos que o n8n recomenda

  • data.records:read: ver os dados dos registros;
  • data.records:write: criar, editar e apagar registros;
  • schema.bases:read: ver a estrutura de uma base, como nomes de tabelas e tipos de campos.

Existe também o escopo webhook:manage, mas o n8n não o pede para estes nós, já que o Trigger consulta o Airtable em vez de esperar um aviso.

Acesso às bases e validade do token

O acesso do token pode ser a uma base, a várias (inclusive de workspaces diferentes) ou a todas as bases de um workspace seu, inclusive as futuras. Recomendamos escolher só as bases que o fluxo usa.

Por padrão, o token não expira; vale até ser apagado ou regenerado. Em planos Enterprise, quem administra pode impor uma validade máxima, e então o erro passa a ser UNAUTHORIZED - Invalid authentication token.

Passo 2: criar a credencial no n8n

No n8n, crie uma credencial do Airtable com o método Access Token e cole o token copiado. No nó Airtable da versão 2, as autenticações disponíveis são Access Token (a padrão) e OAuth2.

Quem preferir OAuth2 numa instalação própria precisa da OAuth Redirect URL do n8n acessível no navegador de quem conecta.

Passo 3: achar a Base e a Table

No nó Airtable da versão 2, os campos Base e Table são obrigatórios e têm três modos: From List, By URL e ID.

O ID da base começa com app e o da tabela com tbl; ambos aparecem na URL com a base aberta no navegador. No modo By URL, o endereço tem o formato https://airtable.com/app.../tbl.../viw....

Passo 4: testar com uma leitura

Antes de gravar, teste a credencial com uma leitura. Crie um workflow com gatilho manual e adicione o nó Airtable. No recurso Record, escolha Search (busca registros específicos ou lista todos) ou Get (traz um registro). Selecione credencial, base e tabela e execute o nó.

No Search, estas opções ajudam: Filter By Formula recebe uma fórmula do Airtable, como NOT({Name} = 'Admin'), e, se ficar vazia, todos os registros voltam; Return All vem ligado; Limit vem em 100.

Passo 5: gravar e atualizar registros

No recurso Record da versão atual do nó, as operações de escrita são:

  • Create: cria um registro novo na tabela;
  • Create or Update: cria o registro ou atualiza o atual, se ele já existir (um upsert);
  • Update: atualiza um registro da tabela;
  • Delete: apaga um registro.

A página do nó na documentação do n8n ainda lista nomes da versão antiga (Append, List e Read, por exemplo); no editor atual, os nomes são os da lista acima.

O nó também tem opções de gravação:

  • Typecast: pede à API do Airtable que tente converter texto em registros ligados e em opções de seleção, na base do melhor esforço. Vem desligado para proteger a integridade dos dados; é uma opção, não uma correção para campos mal mapeados;
  • Update All Matches: existe em Update e em Create or Update e atualiza todos os registros que batem com o valor do campo de casamento (Column to Match On).

Passo 6: montar o Airtable Trigger

Com a leitura e a gravação resolvidas, crie um workflow para o acompanhamento contínuo e adicione o Airtable Trigger. Ele funciona por consulta periódica (polling): é o n8n quem pergunta ao Airtable de tempos em tempos, e o Airtable não envia aviso. Por isso, o Trigger não precisa de URL pública nem de webhook.

Antes de escolher a credencial, abra o campo Authentication: o padrão do nó é "API Key", e essa opção não funciona mais. Troque para Access Token (ou OAuth2) e só então selecione a credencial criada no passo 2.

Depois, preencha:

  • Poll Times: de quanto em quanto tempo o n8n consulta, de a cada minuto até um cron personalizado;
  • Base e Table: obrigatórios, por URL (o padrão) ou por ID;
  • Trigger Field: o campo de data que o gatilho usa.

O Trigger Field e o que conta como novo

O Trigger Field precisa ser um campo do tipo Created Time ou Last Modified Time. Se a tabela não tem um, crie antes, porque sem ele o gatilho não funciona direito.

Com Created Time, o gatilho pega só registros novos; com Last Modified Time, pega registros novos e editados.

A cada consulta, o gatilho pede os registros com data posterior à última checagem. Na primeira execução depois de ativado, a referência é o momento atual, então registros antigos não disparam. No teste manual, ele traz só um registro.

Em Additional Fields, a Formula vale só no polling em produção, não no teste manual.

Passo 7: ativar o workflow

O Airtable Trigger só consulta a base com o workflow ativado. Salve, ative o workflow e espere o primeiro registro novo ou alterado. Se nada chegar logo, pode ser que a tabela ainda não tenha mudado.

Combinações para começar

Um exemplo: um formulário vira registro. Um Form Trigger (ou um Webhook) recebe os dados e liga ao nó Airtable com Record > Create. Para não duplicar quem já se cadastrou, Create or Update com o e-mail como campo de casamento é uma opção.

Um exemplo: um registro novo avisa a equipe. O Airtable Trigger, com um campo Created Time no Trigger Field, liga a um nó de mensagem, como Telegram, Slack ou e-mail. Para outra ferramenta de tarefas, veja Trello no n8n: automatize cartões e quadros.

Um exemplo: uma rotina diária. Um Schedule Trigger chama o nó Airtable com Record > Search e uma Filter By Formula que separa os itens com status pendente, e um nó de e-mail monta o resumo. Para colocar prazos numa agenda, veja Google Calendar no n8n: criar e ler eventos.

Ajuste nomes de campos, filtros e destinos ao que o seu n8n mostra.

Problemas comuns

Estes são os textos e códigos de erro a observar:

  • Forbidden - perhaps check your credentials?: a credencial não tem os escopos necessários para o recurso. Volte ao token e confira os três escopos;
  • 401: credencial inválida;
  • 403 e 404: sem acesso ao recurso ou recurso não encontrado. Na prática, a base pode estar fora do acesso do token, faltar escopo ou haver ID de base ou tabela errado. O Airtable usa a mesma mensagem, INVALID_PERMISSIONS_OR_MODEL_NOT_FOUND, para falta de permissão e recurso inexistente;
  • 422: dados inválidos. Verifique se o nome do campo existe na tabela (maiúsculas e espaços contam) e se o valor combina com o tipo do campo.

Também há limites. Em 16/11/2026, a API do Airtable aceita 5 requisições por segundo por base e 50 por segundo somando todo o tráfego de tokens pessoais de um mesmo usuário. Ao estourar, a resposta é 429, e é preciso esperar 30 segundos até as requisições voltarem a passar. Em lotes grandes, o nó Wait ou a opção Retry on Fail ajudam a respeitar esses limites.

Se o Airtable Trigger não dispara, confira o Trigger Field, a autenticação (se ainda está em "API Key") e se o workflow foi ativado.

Onde ver as páginas de referência

As páginas dos nós Airtable e Airtable Trigger ficam em docs.n8n.io, e a referência da API do Airtable, com escopos, erros e limites, está em airtable.com/developers.

Servidores VPS têm seis planos na loja. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer as VPS

Perguntas frequentes

O Airtable Trigger avisa assim que o registro muda?

Não. Ele consulta a tabela no intervalo definido em Poll Times, e o aviso chega na primeira checagem depois da mudança.

Preciso de domínio ou HTTPS para o Airtable Trigger?

Com Access Token, não. Como o n8n é quem consulta o Airtable, o Trigger não depende de URL pública nem de webhook. Com OAuth2, a OAuth Redirect URL do n8n precisa abrir no navegador de quem conecta a conta.

Posso usar a API key do Airtable?

Não. As API keys deixaram de dar acesso à API em 01/02/2024. Use um Personal Access Token ou OAuth2.

Esta resposta lhe foi útil?

Artigos Relacionados