Airtable no n8n: automatize bases e tabelas
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

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.
- Abra a página de tokens do Airtable (airtable.com/create/tokens) e clique em Create token.
- Dê um nome, como
n8n credential, marque os escopos e escolha o acesso às bases. - 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.