n8n-nodes-cpfhub

CPFHub.io node for n8n — Brazilian CPF Lookup API

Nó CPFHub.io para n8n — API de consulta de CPF

---

What is CPFHub.io?

CPFHub.io is a REST API that returns name, gender, and date of birth from any Brazilian CPF number — in ~300ms, with 99.9% uptime, and full LGPD compliance.

Use this node to add CPF validation and identity lookup to any n8n workflow — no code required.

CPFHub.io é uma API REST que retorna nome, gênero e data de nascimento a partir de qualquer CPF brasileiro. Use este nó para adicionar consulta de CPF em qualquer workflow do n8n — sem escrever código.

10M+ CPFs queried · 1,300+ active companies · 99.9% uptime

---

Installation / Instalação

Via n8n UI (recommended)

1. Open your n8n instance
2. Go to Settings → Community Nodes
3. Click Install
4. Enter n8n-nodes-cpfhub
5. Click Install

Abra sua instância n8n → Configurações → Nós da Comunidade → Instalar → digite n8n-nodes-cpfhub.

Via npm (self-hosted)

npm install n8n-nodes-cpfhub

---

Credentials Setup / Configuração de Credenciais

1. In n8n, go to Credentials → New
2. Search for CPFHub API
3. Paste your API key in the API Key field
4. Click Save

Get your free API key at app.cpfhub.io — no credit card required.

Obtenha sua chave gratuita em app.cpfhub.io — sem cartão de crédito.

---

Operations / Operações

CPF — Lookup

Looks up a CPF number and returns the associated identity data.

Field	Description
CPF	The CPF number to look up (with or without formatting)

Output fields

Field	Type	Description
cpf	String	CPF number (digits only)
name	String	Full name — "Fulano de Tal"
nameUpper	String	Full name in uppercase
gender	String	"M" or "F"
birthDate	String	Date of birth — "DD/MM/YYYY"
day	Number	Birth day
month	Number	Birth month
year	Number	Birth year

---

Example Workflows / Workflows de Exemplo

Onboarding validation

Webhook (receives CPF)
  → CPFHub (Lookup CPF)
  → IF (name matches form input?)
      → True: Send welcome email
      → False: Flag for manual review

E-commerce fraud prevention

WooCommerce / Shopify (new order trigger)
  → CPFHub (Lookup CPF from billing data)
  → IF (CPF valid and name matches?)
      → True: Approve order
      → False: Hold order + notify team on Slack

KYC pipeline with CRM sync

Form submission (Typeform / Tally)
  → CPFHub (Lookup CPF)
  → HubSpot (Create or update contact with verified name)
  → Send confirmation email via Gmail

---

Error Handling / Tratamento de Erros

The node throws descriptive errors for each HTTP status:

Code	Meaning
400	Invalid CPF format
401	Invalid or missing API key
404	CPF not found
429	Rate limit exceeded — retry after a few seconds
500	CPFHub server error
503	Service temporarily unavailable

Enable Continue On Fail in the node settings to handle errors gracefully in your workflow.

---

Rate Limits / Limites de Requisição

Plan / Plano	Limit / Limite
Free / Grátis	1 request every 2 seconds · 50 requests/month
Pro	1 request per second · 1,000 requests/month
Corporate / Corporativo	Custom / Personalizado

---

Plans & Pricing / Planos e Preços

Plan	Price	Included	Extra
Free	R$ 0/month	50 lookups	—
Pro	R$ 149/month	1,000 lookups	R$ 0,15/lookup
Corporate	Custom	Custom	Custom

View full pricing at cpfhub.io →

---

Compatibility / Compatibilidade

• n8n 1.0.0 and above
• Self-hosted and n8n Cloud

---

Links

• Documentation / Documentação
• Dashboard / Painel
• Status Page
• n8n Community Nodes docs
• LGPD Compliance

---

License / Licença

MIT © CPFHub.io