Nationalize in n8n

Add the node

Nationalize ships as a verified community node, so it appears in the standard node picker on n8n Cloud and recent self-hosted versions — no install step.

In the workflow editor, click +, search for Nationalize, and drop the node onto the canvas.

Add your API key

Open the node, click Credentials → Create New Credential, paste your API key from your dashboard, and save.

Credentials are stored encrypted in your n8n instance and reused across workflows.

Example workflow: enrich incoming form submissions

A common pattern: a form submission arrives, you extract the last name, predict nationality, and write the result to a database or downstream tool.

1. Trigger node — webhook, Typeform, Airtable Watch, or whatever produces the name.
2. Nationalize node — set Name to {{ $json.last_name }} (or the field that holds the name).
3. Downstream node — write the result anywhere. Examples: append a row to a Google Sheet, update an Airtable record, post to Slack, store in Postgres.

The Nationalize node returns a JSON object the next step can read with <.property>{{ $json.country[0].country_id }}, <.property>{{ $json.country[0].probability }}, and <.property>{{ $json.count }}.

Example workflow: branch on top-candidate confidence

Nationalize returns up to five country candidates ordered by descending probability. The top candidate's probability is a useful confidence signal.

1. Trigger node.
2. Nationalize node — predicts nationality.
3. IF node — condition {{ $json.country[0].probability }} ≥ 0.5 .
4. True branch — write the top candidate to your primary destination.
5. False branch — send the row to a review queue, or write the full candidate array for human inspection.

This keeps low-confidence rows visible rather than silently picking a top guess.

Quota and rate limits

Each node execution consumes one name from your monthly Nationalize quota. Batched workflows that process many names through the node deduct one per name. The node respects the same X-Rate-Limit-* headers as the API; n8n's retry-on-fail behavior handles transient throttling automatically.

See pricing for tier limits.

Troubleshooting