n8n-nodes-syvel

Official n8n community node for Syvel — disposable email detection API.

Detect throwaway addresses, role accounts, and undeliverable domains before they pollute your database. Works with n8n Cloud, self-hosted n8n, and n8n Desktop.

Install

In your n8n instance, go to Settings → Community Nodes → Install and enter:

n8n-nodes-syvel

You will need a Syvel API key. Get one for free at syvel.io/dashboard.

Quick start

1. Add the Syvel node to your workflow.
2. Create a Syvel API credential with your API key.
3. Select the Check Email operation and map an email field from a previous node.
4. Branch on is_risky — block, tag, or route the item accordingly.

Always enable Fail Open (default: on). If the Syvel API is temporarily unavailable, the node returns a partial result instead of failing your workflow. Never let a third-party service block a legitimate user.

Credentials

| Field | Description | |---|---| | API Key | Your Syvel API key (sv_...). Found in the Syvel dashboard under API Keys. |

Once saved, n8n will verify the credential against the Syvel API automatically.

Operations

Check Email

Checks a full email address. Passing the complete address enables local-part analysis: role account detection (admin@, info@…), random-string patterns, and other signals that can only be extracted from the local part.

| Parameter | Type | Description | |---|---|---| | Email | string | The email address to check, e.g. [email protected]. |

Check Domain

Checks a bare domain without a local part.

| Parameter | Type | Description | |---|---|---| | Domain | string | The domain to check, e.g. yopmail.com. |

Options

Both operations share the following optional settings.

| Option | Type | Default | Description | |---|---|---|---| | Fail Open | boolean | true | If true, returns a partial result (is_risky: null) on API server errors (5xx) instead of failing the node. Recommended. | | Timeout (ms) | number | 3000 | Maximum time in milliseconds to wait for the API. Range: 100–30 000 ms. Keep it low — the API typically responds in under 300 ms. |

Response

| Field | Type | Description | |---|---|---| | is_risky | boolean | true when risk_score ≥ 65. Use as your primary signal. | | risk_score | number | 0 (safe) → 100 (confirmed disposable). | | reason | string | "safe" · "disposable" · "undeliverable" · "role_account" | | deliverability_score | number | 0 (unlikely) → 100 (very likely to be delivered). | | did_you_mean | string \| null | Typo correction suggestion (e.g. "hotmail.com" for "hotmial.com"). | | is_free_provider | boolean | true for consumer webmail (Gmail, Yahoo…). | | is_corporate_email | boolean | true for business domains with professional MX configuration. | | is_alias_email | boolean | true for privacy relay services (SimpleLogin, AnonAddy…). | | mx_provider_label | string \| null | Human-readable name of the mail provider (e.g. "Google Workspace"). |

Risk score interpretation

| Score | Category | Recommended action | |---|---|---| | 0 – 29 | Safe | Accept | | 30 – 49 | Low risk | Accept with caution | | 50 – 79 | High risk | Show a warning | | 80 – 99 | Likely disposable | Block or require confirmation | | 100 | Confirmed disposable | Block |

Error handling

The node handles all Syvel API errors with human-readable messages in the n8n UI.

| HTTP code | Behaviour | |---|---| | 401 | Throws "Authentication failed. Please check your Syvel API key." | | 422 | Throws "Invalid input: … is not a valid domain or email format." | | 429 | Throws "Syvel API rate limit exceeded. Please check your plan quota." | | 5xx | Returns partial result if Fail Open is enabled; otherwise throws. |

You can also enable Continue On Error in the node settings to push all errors to the output instead of failing the workflow.

Use cases

Block disposable emails at sign-up

Webhook (form submit)
  └─ Syvel — Check Email
       ├─ is_risky = true  → Respond to Webhook (400 "Invalid email address")
       └─ is_risky = false → Create user in database

Tag risky leads in your CRM

Schedule Trigger (daily)
  └─ Get Leads (HubSpot / Salesforce)
       └─ Syvel — Check Email
            ├─ is_risky = true  → Update Lead (tag = "disposable")
            └─ is_risky = false → no action

Typo correction before sending a campaign

Get Contacts (Mailchimp)
  └─ Syvel — Check Email
       └─ did_you_mean ≠ null → Update Contact (email = did_you_mean)

Contributing

Pull requests are welcome. For major changes, please open an issue first.

git clone https://github.com/Syvel-io/n8n-nodes-syvel.git
cd n8n-nodes-syvel
npm install

# Run tests
npm test

# Watch mode
npm run test:watch

# Build
npm run build

# Lint
npm run lint

This project uses Gitmoji for commit messages. See .github/COMMIT_CONVENTION.md for the full reference.

Documentation

Full documentation, API reference, and integration guides:
syvel.io/fr/docs/integrations/n8n

License

MIT