Developer API & Guides.

Sortwell verifies email addresses before you send campaigns. Direct SMTP handshakes, MX record checks, disposable domain detection, and catch-all flags in a single fast JSON API.

Authentication

Authenticate your requests using an API key generated from the Sortwell dashboard. Keys begin with the prefix ev_live_.

Supply your key via either the x-api-key or standard Authorization: Bearer header:

Need an API key? Generate one with custom rate limits in Settings > API keys.

Runs real-time verification of a single email address. Queries DNS MX servers, establishes a zero-send SMTP handshake, inspects disposable and role patterns, and deducts 1 credit.

curl -X POST https://www.sortwell.xyz/api/v1/verify \
  -H "x-api-key: ev_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]"
  }'

Response Attributes

Tests API credentials and returns active credit balance, daily quota, and subscription plan. Automatically invoked during n8n credential connection tests.

curl -X GET https://www.sortwell.xyz/api/v1/account \
  -H "x-api-key: ev_live_your_api_key_here"

Sample 200 OK Response

{
  "success": true,
  "data": {
    "id": "user_2s8...",
    "email": "[email protected]",
    "name": "Alex Turner",
    "plan": "growth",
    "creditsRemaining": 4850,
    "dailyCredits": 500
  }
}

n8n Community Node

Install the verified Sortwell community node package n8n-nodes-sortwell directly from the n8n community directory.

Looking for pre-configured templates? Head over to our Integrations Hub to copy instant workflow recipes.

HTTP Status Codes