Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt

SentriSend Email Validation

✓ vom Dienst · sentrisend.com

von sentrisendVersion 0.1.0i★ 0iLäuft in der CloudOffizielle Website ↗
Name in der Registrycom.sentrisend/validation

So installierst du es

What it does

SentriSend checks email syntax, disposable domains and DNS/MX records; it never sends email.

  • Connects Läuft in der Cloud
  • Account or key Needs Authorization
  • Category Chat & E-Mail

Warum es hier steht

Dieser Eintrag steht im Tab „Apps, die sich mit KI verbinden“, der ohne Sterne in dieser Reihenfolge sortiert

1. In Claudes Connector-VerzeichnisNein
2. Vom Team getestetNein
3. Für Nutzer in Thailand geeignetNein
4. Nutzung ohne Sterne20/100Beliebtheit 0 · Aktualität 12 · Antwortet noch 8 · Likes von Nutzern +0
5. Eingetragen am2026-11-16

Likes von Nutzern: 0 · Höchstens 5 Punkte (1 pro Person). Nicht käuflich.

Qualität: 4/4 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte SentriSend Email Validation. Folge https://mcp.popnx.com/i/sentrisend-validation.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

4/4 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (sentrisend.com) · ✓ Befehle geprüft am 17. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 5 Min.

Du brauchst einen Schlüssel von SentriSend Email Validation (auf der Seite des Anbieters erstellen) · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Bei SentriSend Email Validation registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  2. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameSentriSend Email Validation
    Remote MCP server URL · Adressehttps://sentrisend.com/mcp

    Unter Request headers diesen Namen und Wert hinzufügen

    Header-NameAuthorization
    WertBearer <Schlüssel hier einfügen>

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  4. Im Chat einschalten

    +ConnectorsSentriSend Email Validation

  5. Ausprobieren

    Nutze SentriSend Email Validation und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es SentriSend Email Validation nutzt, oder ein Werkzeug von SentriSend Email Validation in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

ChatGPT kann SentriSend Email Validation noch nicht verbinden

SentriSend Email Validation braucht zum Verbinden deinen eigenen Schlüssel, aber die OpenAI-Hilfe beschreibt nur die Anmeldung per OAuth; eine Schlüssel-Option konnten wir nicht bestätigen

Das kannst du stattdessen tun

A · Eine App nutzen, die SentriSend Email Validation verbinden kann

  • Du brauchst einen Schlüssel von SentriSend Email Validation (auf der Seite des Anbieters erstellen) · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu
  • Du brauchst einen Schlüssel von SentriSend Email Validation (auf der Seite des Anbieters erstellen)
  • Du brauchst einen Schlüssel von SentriSend Email Validation (auf der Seite des Anbieters erstellen)
  • Du brauchst einen Schlüssel von SentriSend Email Validation (auf der Seite des Anbieters erstellen)

B · Andere in Chat & E-Mail, die mit ChatGPT funktionieren

Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden

Klappt mit Claude Code · etwa 5 Min.

Du brauchst einen Schlüssel von SentriSend Email Validation (auf der Seite des Anbieters erstellen)

  1. Bei SentriSend Email Validation registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  2. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  3. Diesen Befehl einfügen und Enter drücken

    claude mcp add --transport http --scope user validation https://sentrisend.com/mcp --header 'Authorization: Bearer your-value'

    Ersetze „your-value“ vor dem Enter durch deinen Schlüssel

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. /mcp in Claude Code eingeben

    SentriSend Email Validation sollte in der Liste als verbunden erscheinen

  5. Ausprobieren

    Nutze SentriSend Email Validation und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es SentriSend Email Validation nutzt, oder ein Werkzeug von SentriSend Email Validation in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 5 Min.

Du brauchst einen Schlüssel von SentriSend Email Validation (auf der Seite des Anbieters erstellen)

  1. Bei SentriSend Email Validation registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  2. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  3. Schlüssel eintragen

    In den Einstellungen von SentriSend Email Validation ist Authorization leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. KI-Chat in Cursor im Agent-Modus öffnen

  5. Ausprobieren

    Nutze SentriSend Email Validation und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es SentriSend Email Validation nutzt, oder ein Werkzeug von SentriSend Email Validation in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 5 Min.

Du brauchst einen Schlüssel von SentriSend Email Validation (auf der Seite des Anbieters erstellen)

  1. Bei SentriSend Email Validation registrieren und Schlüssel erstellen

    Öffne die Seite des Anbieters, registriere dich und erstelle einen API-Schlüssel für den nächsten Schritt. Preise und Gratis-Tarife siehst du auf seiner Seite.

    Wie du einen Schlüssel bekommst, steht unten im README des Anbieters

  2. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  3. Schlüssel eintragen

    In den Einstellungen von SentriSend Email Validation ist Authorization leer; trag deinen Schlüssel ein und speichere

    Füge den Schlüssel nur in das Feld der App ein, nie in einen Chat und schick ihn niemandem

  4. KI-Chat in VS Code im Agent-Modus öffnen

  5. Ausprobieren

    Nutze SentriSend Email Validation und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es SentriSend Email Validation nutzt, oder ein Werkzeug von SentriSend Email Validation in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://sentrisend.com/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die SentriSend Email Validation nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

claude mcp add --transport http --scope user validation https://sentrisend.com/mcp --header 'Authorization: Bearer your-value'

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "validation": {
      "url": "https://sentrisend.com/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "validation": {
      "type": "http",
      "url": "https://sentrisend.com/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

Werte, die du selbst einträgst

  • Authorization geheim erforderlich HTTP header
    SentriSend-API-Schlüssel im Bearer-Format
    Englisches Original anzeigenSentriSend API key using the Bearer format

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
Nicht auf npm/PyPI
Bestätigte Domain
✓ sentrisend.com
Verbindung
Läuft in der Cloud
Transport
streamable-http
Neueste Versioni
0.1.0
In der Registry veröffentlichti
17. Nov. 2026
Code zuletzt geänderti
18. Nov. 2026
Zuletzt geprüft
17. Nov. 2026
Entwickler
sentrisend
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Tool-Namen und -Beschreibungen genau so, wie der Server sie am 17. Nov. 2026 gemeldet hat. Geschrieben hat sie der Entwickler, nicht wir; wir zeigen sie als reinen Text.

  • validate_email

    Validate one email address with SentriSend's existing validation API. Checks syntax, disposable-domain status, and DNS/MX records; it does not check whether a specific mailbox exists. Uses the connected SentriSend API key and the same monthly request allowance as a direct validat

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde über die Domain sentrisend.com bestätigt (die Registry prüft, wem die Domain gehört)

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: gestern

  • – Nicht zutreffend

    Hat eine Lizenz

    Nicht relevant: Cloud-Server des Inhabers von sentrisend.com; du führst keinen Code aus dem Repo aus

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 334 ms (HTTP 200)

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Keine Anmeldung nötig

  • ✓ Bestanden

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Wir haben 1 Tool-Beschreibungen gelesen und keine versteckten Anweisungen an die KI gefunden

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/sentrisend-validation.svg)](https://mcp.popnx.com/en/servers/sentrisend-validation)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Chat & E-Maili

  • Mehr Sterne als 0 % der anderen 2024 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 90 % der anderen 2024 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 2024 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist SentriSend Email Validation sicher?

Er hat 4 von 4 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: Authorization

Läuft er auf meinem Computer oder in der Cloud?

Er läuft in der Cloud des Entwicklers. Du verbindest dich übers Internet, ohne etwas zu installieren, aber was du sendest, läuft über die Server des Entwicklers.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt gestern geändert, und die neueste Version (0.1.0) kam vorgestern in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: emailmd, Kite Discord Bot Builder, e2a — email for AI agents, Infobip MCP, kernelCAD

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

emailmd

Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.

von anypostWeit verbreitet↓ 5432/Wo.★ 1394Aktualisiert vor 5 Tagen

Computer oder Cloud✓ vom Dienst · emailmd.dev

Kite Discord Bot Builder

Build and fix Discord bots from a chat. Kite hosts them 24/7, with no code to deploy.

von merlinfuchsWachsend★ 334 Sterne des ganzen ReposAktualisiert vor 22 Tagen

Läuft in der Cloud✓ vom Dienst · kite.onl

e2a — email for AI agents

Authenticated email gateway for AI agents — per-agent inboxes, HITL approval, SPF/DKIM verified.

von tokencanopyWachsend★ 200 Sterne des ganzen ReposAktualisiert vor 4 Monaten

Läuft in der Cloud✓ vom Dienst · e2a.dev

Infobip MCP

Infobip MCP server for omnichannel communication and messaging. SMS, RCS, WhatsApp, Viber and more.

von infobipAm Anfang★ 36Aktualisiert vor 13 Monaten

Läuft in der Cloud✓ vom Dienst · infobip.com

kernelCAD

CAD in ChatGPT and Claude: editable parts, STEP/STL/drawings, in-chat 3D, automatic checks.

von w1neAm Anfang★ 35Aktualisiert vor 23 Tagen

Läuft in der Cloud✓ vom Dienst · kernelcad.com
Im Vergleich mit ähnlichen
Dieser
SentriSend Email Validation
emailmdKite Discord Bot Buildere2a — email for AI agentsInfobip MCPkernelCAD
Läuft woLäuft in der Cloud, keine InstallationIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselJaNeinNeinNeinNeinNein
Mit + in Claude hinzufügenNeinNeinNeinNeinJaNein
Basisprüfungen4/45/54/44/44/44/4
LizenzMITMITAGPL-3.0Apache-2.0MITMIT
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

SentriSend

Email validation, gated sending and a signup-protection hook for Supabase, as a simple HTTP API.

SentriSend checks an email address *before* you send to it or let it sign up: is the syntax valid, is the domain a known disposable provider, does the domain exist, and can it receive mail? It can also send the message for you behind sender-reputation controls and return a signed audit receipt.

What you can use it for:

  • Validate addresses in signup forms and before sending (POST /validate, or the npm package).
  • Block disposable and non-existent domains in Supabase Auth with a hosted "Before User Created" hook. No code to deploy: guide.
  • Send through a gateway that runs the same address checks, content and threat checks, rate limits and a sender-reputation circuit breaker before the message goes to your delivery provider (POST /send).

Links:

  • Website and free key: https://sentrisend.com
  • API base URL: https://sentrisend.com/api/v1
  • Built by Bench Tech Audio Ltd

This repository holds the public documentation and examples. The service itself is hosted; its source code is not published here.


What it checks

POST /validate runs these checks on one address:

CheckDetail
SyntaxThe address is a plain name@domain address of 3-254 characters. Quoted and internationalised address forms are not supported.
Disposable domainsMatched against a bundled list of about 134,100 disposable domains, including their subdomains.
Domain existsA live DNS lookup tells a non-existent domain apart from a domain with no mail records.
Can receive mailLooks for MX records. If there are none, a usable IPv4 A record is accepted as a fallback. An explicit "null MX" (a domain that says it takes no mail) is rejected.

What it does not do. It does not confirm that a particular mailbox exists, it does not contact the recipient's mail server, and it does not detect role accounts (such as info@), suggest typo fixes or detect bots. A passing result means the domain can receive mail, not that the person's mailbox is real.

If DNS is slow or unavailable, the address is allowed with a MEDIUM risk score and the reason DNS_INCONCLUSIVE, rather than being rejected.


Quick start

  1. Get a free key at https://sentrisend.com. Keys start with ss_live_. There is one free key per normalised email address (see Free keys).
  2. Keep the key secret. Use it from your server, never from browser code.
Validate an address
curl -X POST 'https://sentrisend.com/api/v1/validate' \

-H 'Authorization: Bearer YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -d '{"email":"user@example.com"}'

Allowed (HTTP 200):

{"allowed":true,"disposable":false,"risk_score":"LOW"}

Blocked (HTTP 400):

{"allowed":false,"disposable":true,"reason":"DISPOSABLE_DOMAIN","risk_score":"HIGH"}

reason is DISPOSABLE_DOMAIN, DOMAIN_NOT_FOUND or NO_MX_RECORDS for blocked addresses (HTTP 400), or DNS_INCONCLUSIVE for an address that is allowed because DNS could not be checked (HTTP 200, MEDIUM risk).

/validate accepts the key only as Authorization: Bearer YOUR_API_KEY.

Use the npm package
npm install sentrisend
import { validate } from "sentrisend";

const result = await validate("user@example.com", { apiKey: process.env.SENTRISEND_API_KEY }); if (result.allowed === false) console.log("Blocked:", result.reason);

Node.js 18 or newer, no runtime dependencies. The default failureMode: "open" allows the address on timeout, network failure or API 5xx; "closed" throws instead. Server-side only. The package validates addresses; it does not send email. See sentrisend on npm.

Send an email
curl -X POST 'https://sentrisend.com/api/v1/send' \

-H 'Authorization: Bearer YOUR_API_KEY' \ -H 'Content-Type: application/json' \ -H 'Idempotency-Key: welcome-email-001' \ -d '{ "to": "user@example.com", "subject": "Welcome", "html": " Your account is ready. " }'

With a free key, replace `user@example.com` with your own address, the one you signed up with. Any other recipient returns 403 RECIPIENT_NOT_VERIFIED.

/send runs the same address checks first, plus content-policy and threat-signature checks, abuse controls and sender-reputation checks, then hands the message to the delivery provider. It accepts the key as Authorization: Bearer ... or as x-api-key: ... (if both are sent, x-api-key is used).

Success (HTTP 200). The values shown are illustrative:

{

"success": true, "status": "DELIVERED", "providerId": "PROVIDER_MESSAGE_ID", "attempts": 1, "complianceProof": "hmac-sha256:v1:<64 hex characters>", "receipt": "hmac-sha256:v1: ", "riskLevel": "LOW", "riskScore": 0, "advisories": [] }

"Delivered" means the delivery provider accepted the message. It is not confirmation that it reached an inbox. status can also be DELIVERED_AFTER_RETRY; attempts is 1 to 3; providerId can be null.

Request fields for /send
FieldRequiredNotes
toYesOne address, or a non-empty array of addresses.
subjectYes3-100 characters.
htmlYesAt least 5 characters.
textNoPlain-text alternative. If supplied, at least 1 character.
fromNoSender address, with or without a display name. Some sender identities are reserved, and your delivery provider must accept the address.
reply_toNoReply address.
intendedUseNoFree-text label. Defaults to General Notification.
whiteLabelNoRequests white-label sending. It only takes effect if SentriSend has enabled it for your account (see Limits and pricing).

The request body is limited to 100 KB. The optional Idempotency-Key header (1-256 characters from A-Z a-z 0-9 . _ : -) makes retries safe: reuse the same value for retries of the same email. If you leave it out, a repeat request is treated as a new email.


Supabase signup protection (hosted hook)

SentriSend can check every new signup in Supabase Auth before the account is created, using Supabase's "Before User Created" HTTP hook. There is nothing to deploy.

  1. Get a SentriSend key and create a hook in the SentriSend dashboard. You receive a hook URL and a signing secret.
  2. In Supabase, open Authentication > Hooks > Before User Created, choose the HTTP option, and paste the URL and secret.
  3. Test with a signup.
  • Allowed signups get HTTP 200 {}.
  • Blocked signups get HTTP 200 with a Supabase error object (http_code 400, "This email address can't be used to sign up."). The 200 status is intentional: Supabase currently passes hook errors through only when the hook returns 200 or 202.
  • Fail-open: if a check times out or fails, the signup is allowed. A missing email, a disabled hook or an unknown hook ID are also allowed.
  • Requests are signature-checked (Standard Webhooks). The hook has its own limit of 60 requests a minute.
  • Safe retries: a retried request gets the earlier verdict and is not charged twice.
  • In our testing, users created directly from the Supabase dashboard do not trigger this hook.

We have tested allow and block against a real Supabase project. Full guide: https://sentrisend.com/supabase


Sender-reputation circuit breaker

Sends are tied to an API key, and delivery events (delivered, bounced, complained) are fed back to SentriSend. When a key's recent hard bounces or complaints get too high, the gateway first warns, then slows the key down, and then pauses it. A paused key needs an administrator to un-pause it, after which it runs under a probation period. The aim is to stop one bad send run from damaging your provider account. The exact thresholds are not published.

The stages are covered by automated tests. A live end-to-end threshold test against real bounce events is still to be done, so treat the breaker as new.


Errors

The error format is not uniform yet (see the roadmap). Check the HTTP status first, then code or status.

/validate
HTTPCodeMeaning
400INVALID_EMAILThe address is missing or malformed.
400*(no code; allowed: false)*A blocked verdict, with a reason.
401-Missing or invalid key.
403-Subscription inactive.
429RATE_LIMITEDToo many requests. Includes a Retry-After header and a retry_after field.
429QUOTA_EXCEEDEDMonthly allowance used up.
503-Authentication, quota or rate-limit service unavailable.
/send
HTTPCodeWhat to do
400INVALID_EMAIL, DISPOSABLE_DOMAIN_REJECTED, DOMAIN_NOT_FOUND, NO_MX_RECORDSFix the address. Don't retry unchanged.
403RECIPIENT_NOT_VERIFIEDFree keys can only send to the key owner's address.
409IDEMPOTENCY_CONFLICTThat Idempotency-Key was already used for different content.
409IDEMPOTENCY_IN_PROGRESSThe original request is still processing, or its outcome is unconfirmed. Retry with the same key, never a new one.
429QUOTA_EXCEEDEDMonthly allowance used up.
429DAILY_SEND_LIMITFree keys: daily send cap reached; resets at 00:00 UTC.
429recipient_rate_limitedToo many sends to the same recipient. Wait before retrying.
429SENDER_REPUTATION_SLOWDOWNThe key is being slowed because of recent bounces or complaints.
403SENDER_REPUTATION_PAUSEDThe key is paused. Contact SentriSend.
503SENDER_REPUTATION_UNAVAILABLEThe reputation check could not be completed. The send is not made.
503IDEMPOTENCY_UNCONFIRMEDResponse has doNotRetry: true. Check what happened to the original request first.

Some responses carry a status field instead of a code:

HTTPstatusMeaning
403BLOCKED, BLOCKED_BY_GLOBAL_INTELLIGENCERejected by a content-policy or threat check.
502DELIVERY_FAILEDThe provider reported a failure. The body has providerError and attempts. Read the error before deciding whether to retry.
503DELIVERY_UNCONFIRMEDResponse has doNotRetry: true. Don't resend blindly.
503AUDIT_UNCONFIRMEDThe provider already accepted the email. Don't send it again.

These tables are not exhaustive. You may also see 401 (missing or invalid key), 403 (inactive subscription), 413 (request body too large), other 400 responses with only error and details, and other 503 responses with no code.


Free keys

  • One free key per normalised email address. Normalisation removes +tags on every domain, removes dots only for Gmail and Googlemail addresses, and treats googlemail.com as gmail.com. So you+test@example.com and you@example.com count as the same address.
  • Already have a free key? On the sign-up form choose "Regenerate my existing free key". A new sign-up for the same address will not send an email.
  • Sign-up needs a human check and email verification before the key is shown.
  • A free key can send only to its owner's address (including those equivalent spellings), and no more than 10 sends per UTC day.

Recommended pattern: fail open

Validation should never be the reason a real person can't sign up. Block only on a definite "no" and let everything else through. Here is an example for a signup form (Node 18+):

export async function checkEmail(email, { apiKey, baseUrl = "https://sentrisend.com/api/v1", timeoutMs = 800 } = {}) {

try { const res = await fetch(${baseUrl}/validate, { method: "POST", headers: { Authorization: Bearer ${apiKey}, "Content-Type

Nur der Anfang wird gezeigt; den Rest findest du im Repo