Mailchimp no n8n: automatize listas e contatos
Crie a credencial, cadastre contatos com o status certo, aplique tags, descadastre sem apagar o registro e receba os avisos da audiência com o Mailchimp Trigger.
Por Redação Eleven Host · @robson.direitodigital · 17 de novembro de 2026 · 8 min de leitura

Capa da Redação Eleven Host para o guia: Mailchimp no n8n: automatize listas e contatos Arte: Eleven Host
Usar mailchimp no n8n é ligar a sua audiência aos fluxos: o nó Mailchimp cria, lê, atualiza e apaga contatos, mexe em tags e lista grupos, e o Mailchimp Trigger avisa o n8n quando alguém se inscreve ou sai da lista.
No nó Mailchimp do n8n, a operação Delete do recurso Member apaga o contato de vez. Para só tirar alguém da lista, use Update com Status em unsubscribed.
Atualizado em 17/11/2026. Em 17/11/2026, a versão estável do n8n é a 2.48.4, publicada em 13/11/2026. Nela, o nó Mailchimp está na versão 1.1, que é a padrão, e o Mailchimp Trigger está na versão 1.
O que são o nó Mailchimp e o Mailchimp Trigger
O nó Mailchimp consome a API do Mailchimp. Em Authentication, o padrão é API Key, e a outra opção é OAuth2. Em Resource, o padrão é Member, e as opções são Campaign, List Group, Member e Member Tag.
Cada recurso tem as suas operações. Em Member, há Create, Delete, Get, Get Many e Update. Em Member Tag, há Create, que adiciona tags a um contato, e Delete, que remove tags. Em List Group, há Get Many, que lista os grupos de interesse de uma categoria. Em Campaign, o padrão é Get Many, e as operações são Delete, Get, Get Many, Replicate, Resend e Send.
O Mailchimp Trigger começa o fluxo quando a audiência muda. Ele usa um webhook, que é um aviso que o Mailchimp envia ao n8n.
Para quem serve
Serve para quem usa o Mailchimp e roda o n8n em servidor próprio: cadastrar no Mailchimp quem preenche um formulário, marcar clientes com tags e avisar outro sistema quando alguém se descadastra. Para o básico de servidor, há o artigo sobre servidor VPS.
Uma opção de infraestrutura é a VPS da loja da Eleven Host. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ir à loja
Passo 1: criar a credencial Mailchimp API
No Mailchimp, gere a chave na seção de chaves de API da sua conta. Recomendamos guardar a chave só na credencial do n8n, e não dentro do fluxo.
No n8n, crie a credencial Mailchimp API, que tem um único campo, o API Key. Cole a chave inteira, com o trecho que vem depois do último hífen, por exemplo -us6. O n8n usa esse trecho para achar o servidor da sua conta, e sem ele a conexão não é feita.
A alternativa é a credencial Mailchimp OAuth2 API. Ela serve para acessar dados da conta de outra pessoa. Num n8n instalado por você, se for configurar o OAuth2 do zero, registre um aplicativo no Mailchimp.
Passo 2: criar um contato
Crie um workflow com gatilho manual e um nó Mailchimp com Resource em Member e Operation em Create. Três campos são obrigatórios: List Name or ID, que carrega as listas da sua conta, Email e Status.
Os valores de Status
subscribed: o contato entra como inscrito;pending: o contato entra com o status pendente;unsubscribed: o contato fica descadastrado;cleaned: valor aceito pelo campo;transactional: valor aceito pelo campo.
Para quem chegou por um formulário, recomendamos pending, e subscribed só para quem já deu permissão para receber os e-mails.
Abaixo dos campos obrigatórios, o nó oferece mais campos. Em Merge Fields, escolha o campo da lista em Field Name or ID e informe o valor em Field Value. Em Interest Groups, informe a categoria, o Category Field ID e o valor, que liga ou desliga o grupo.
Em Options, ficam Email Type (html ou text), Language, Opt-in IP, Signup IP, Signup Timestamp, Opt-in Timestamp, Tags e Vip.
Recomendamos deixar de fora Signup Timestamp e Opt-in Timestamp, a menos que você confira a data gravada num contato de teste.
Passo 3: marcar contatos com tags
Há dois caminhos. O primeiro é o campo Tags, dentro de Options da operação Create, onde as tags vão separadas por vírgula. Escreva sem espaço depois da vírgula, como cliente,vip. Com espaço, o nome da segunda tag pode ficar com um espaço na frente.
O segundo é o recurso Member Tag. Em Create, informe a lista, o e-mail e as tags, uma por valor, com o botão Add Tag. Em Delete, as tags informadas são removidas do contato.
Na prática, no n8n o nome do contato vai em Merge Fields, como o campo FNAME do exemplo mais abaixo, e uma marca como "cliente" vai numa tag.
Passo 4: buscar, atualizar e descadastrar
Em Member > Get, informe a lista e o e-mail para ler um contato, com as opções Fields e Exclude Fields para escolher o que volta. Em Get Many, escolha a lista e use Return All para trazer todos os contatos ou Limit para limitar, com padrão de 500 e máximo de 1000.
Em Member > Update, informe a lista e o e-mail e preencha Update Fields, onde estão Email Type, Interest Groups, Language, Merge Fields, Opt-in IP, Signup IP, Skip Merge Validation, Status, Vip e Location. Para descadastrar, escolha Status em unsubscribed.
Em Member > Delete, o contato é apagado de forma permanente. Não é arquivamento. Por isso, recomendamos usar Delete só quando a intenção for mesmo remover o registro, e Update com unsubscribed no resto dos casos.
O que o nó não faz
O nó não tem uma operação de criar ou atualizar no mesmo passo. Create é para contato novo, e Update é para contato que já está na lista. Não conte com o Update para cadastrar alguém que ainda não existe.
No recurso Campaign, o nó trabalha com campanhas que já existem: apaga, lê, replica, reenvia e envia. A operação Resend cria um reenvio para quem não abriu a campanha. Criar ou editar campanha, criar lista ou criar campo da audiência não estão entre as operações do nó. Faça essas etapas no próprio Mailchimp.
Passo 5: receber avisos com o Mailchimp Trigger
No Mailchimp Trigger, escolha a credencial, a lista e dois campos obrigatórios: Events e Sources. Em Events, as opções são Campaign Sent (campanha enviada ou cancelada), Cleaned, Email Address Updated, Profile Updated, Subscribe e Unsubscribe. Em Sources, as opções são User, para ações do próprio inscrito, Admin, para ações do administrador no painel web, e API, para ações feitas pela API.
O n8n cria o webhook no Mailchimp quando o fluxo é publicado e ativado, e apaga o webhook quando o fluxo é desativado.
O Mailchimp é quem chama o seu fluxo, então o n8n precisa de uma URL pública com HTTPS válido. O endereço localhost não funciona. Antes de ativar o fluxo, defina a URL pública. Com proxy reverso, defina N8N_WEBHOOK_URL com o endereço público (por exemplo, https://n8n.exemplo.com/), como no exemplo do n8n, que usa também N8N_PROXY_HOPS=1 e em que o último proxy envia os cabeçalhos X-Forwarded-For, X-Forwarded-Host e X-Forwarded-Proto. A variável antiga WEBHOOK_URL está obsoleta desde o n8n 2.35.0 e gera aviso no log.
Assinatura do aviso
O Mailchimp Trigger confere a assinatura do aviso só quando o Mailchimp devolve um segredo ao criar o webhook. Sem esse segredo guardado, a conferência é pulada. Nesse caso, quem souber a URL do webhook pode mandar um evento falso, então recomendamos manter o endereço restrito.
Combinações para começar
Um exemplo: formulário do site vira contato. Um Webhook ou Form Trigger recebe o nome e o e-mail. Em seguida, Member > Create cadastra o contato com Status em pending e Merge Fields com o campo FNAME recebendo o nome. Depois, Member Tag > Create aplica a tag "site". Depois de rodar o fluxo, confira o contato na lista do Mailchimp.
Um exemplo: cliente que comprou ganha uma tag. O Webhook de uma loja avisa do pedido pago, e Member Tag > Create aplica a tag "cliente", que serve para segmentar campanhas. Para o lado da loja, veja WooCommerce no n8n: automatize pedidos da loja.
Um exemplo: descadastro avisa outro sistema. O Mailchimp Trigger, com Events em Unsubscribe e Sources em User, alimenta um nó que atualiza uma planilha ou um CRM, para a equipe não contatar a pessoa por outros canais. Para ligar esse aviso a um CRM, veja HubSpot no n8n: automatize contatos e negócios.
Problemas comuns
- A conexão não é feita: confira se a chave foi colada inteira, com o trecho depois do hífen;
- Contato sumiu de vez: foi usado Delete, que apaga de forma permanente; para só descadastrar, use Update com unsubscribed;
- Contato novo não apareceu: o Update não é a operação para criar; use Create;
- O aviso não chega: confira se o fluxo está publicado e ativo e se a URL pública, com HTTPS válido, está certa;
- Tag com espaço na frente: escreva as tags sem espaço depois da vírgula.
O servidor do n8n
Onde o n8n roda é uma decisão à parte da montagem dos fluxos.
O Bronze é o mais barato dos seis planos de VPS da loja. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Conferir VPS
Perguntas frequentes
O n8n tem nó do Mailchimp?
Sim. Há o nó Mailchimp, na versão 1.1 como padrão, e o Mailchimp Trigger, na versão 1.
Qual operação cria contato?
Member > Create, com List, Email e Status. Para quem chegou por um formulário, recomendamos o Status pending.
O Delete é o mesmo que descadastrar?
Não. Delete apaga o contato de forma permanente. Para descadastrar, use Update com Status em unsubscribed.
O Mailchimp Trigger funciona sem URL pública?
Não. O Mailchimp precisa alcançar o n8n por uma URL pública com HTTPS válido, e o fluxo precisa estar publicado.