Zum Inhalt springen
Doku

Anleitung

Jede Kontaktliste hat eine Anmelde-URL, die Personen ohne API-Schlüssel hinzufügt. Erfahren Sie, wie Anfragen aufgebaut sind, was sich mit Double-Opt-in ändert, wie Sie die URL sicher aufrufen, welche Limits gelten und wie Sie sie zurücksetzen.

Aktualisiert am 20. Okt. 2026

Jede Kontaktliste hat eine Anmelde-URL: einen öffentlichen Endpunkt, der eine Person ohne API-Schlüssel zur Kontaktliste hinzufügt. Damit verbinden Sie ein Anmeldeformular auf Ihrer Website oder ein No-Code-Tool, das eine JSON-Anfrage senden kann, mit einer Kontaktliste. Es ist ein Endpunkt für POST-Anfragen, keine Seite: Wenn Sie die URL im Browser öffnen, wird niemand angemeldet.

Text
POST https://api.emailit.com/subscribe/{token}

Das token ist das Geheimnis der Kontaktliste. Wer die URL hat, kann Adressen zur Kontaktliste hinzufügen. Behandeln Sie sie daher wie ein Passwort.

URL finden

  1. Kontaktliste öffnen. Öffnen Sie Email MarketingAudiences und wählen Sie die Kontaktliste.

  2. URL kopieren. Wählen Sie Subscribe URL und kopieren Sie die URL aus dem Dialog. Der Dialog zeigt außerdem eine Beispielanfrage und ob Double-Opt-in aktiviert ist.

Per API liefert Kontaktliste abrufen denselben Wert in token.

Anfrageformat

Senden Sie eine POST-Anfrage mit JSON-Body und Content-Type: application/json. Der Header Authorization ist nicht nötig.

emailstringerforderlich
Die Adresse, die angemeldet werden soll. Wird in Kleinbuchstaben gespeichert.
first_namestring
Der Vorname der Person. Überschreibt den gespeicherten Vornamen eines bestehenden Kontakts, wenn er nicht leer ist.
last_namestring
Der Nachname der Person. Überschreibt den gespeicherten Nachnamen eines bestehenden Kontakts, wenn er nicht leer ist.
custom_fieldsobject
Werte, zugeordnet nach dem Schlüssel des eigenen Felds. Wird mit den Werten eines bestehenden Kontakts zusammengeführt: Gesendete Schlüssel werden überschrieben, alle anderen bleiben erhalten.

Der Endpunkt liest nur JSON. Formularkodierte Bodys, wie sie ein einfaches HTML-<form> sendet, werden mit 400 und „Invalid JSON in request body“ abgelehnt.

Antworten

Status Body Wann
200 { "message": "Subscribed successfully", "status": "subscribed" } Double-Opt-in ist deaktiviert, und die Person wurde hinzugefügt, erneut angemeldet oder war bereits angemeldet.
202 { "message": "Check your inbox to confirm the subscription.", "status": "pending" } Double-Opt-in ist aktiviert: Die Double-Opt-in-E-Mail wurde gesendet, und die Person wird angemeldet, wenn sie auf den Link darin klickt. Bereits angemeldete Personen und Personen, die sich direkt nach der ersten Anmeldung erneut anmelden, erhalten dieselbe Antwort ohne neue E-Mail.
400 { "error": "Missing required field: email" } oder { "error": "Invalid email format" } Die E-Mail-Adresse fehlt oder ist fehlerhaft, oder der Body ist kein JSON.
403 { "error": "Workspace suspended" } oder { "error": "Workspace scheduled for deletion" } Der Workspace ist gesperrt oder zur Löschung vorgemerkt und nimmt daher keine Anmeldungen an.
404 { "error": "Audience not found" } Das Token ist falsch oder wurde zurückgesetzt, oder die Kontaktliste ist archiviert.
422 { "error": "...", "usage": { ... } } Die Kontaktliste hat ihr Abonnentenlimit erreicht.
429 Mehr als 30 Anfragen pro Minute von derselben IP-Adresse oder, wenn Double-Opt-in oder die Anmeldebestätigung aktiviert ist, zu viele Anmeldungen für die Kontaktliste oder aus Ihrem Netzwerk in der letzten Stunde. Versuchen Sie es nach der Anzahl Sekunden im Header retry-after erneut.
503 { "error": "The double opt-in email could not be sent. Please try again later.", "code": "..." } Double-Opt-in ist aktiviert, aber die Double-Opt-in-E-Mail konnte nicht gesendet werden, etwa weil die Versanddomain nicht verifiziert ist oder der Workspace keine Credits mehr hat. Die Person wird nicht hinzugefügt.

Was eine Anmeldung bewirkt

  • Neue Adresse: Emailit legt den Kontakt an und meldet ihn bei der Kontaktliste an.
  • Bestehender Kontakt, nicht auf der Kontaktliste: Emailit aktualisiert die gesendeten Namen und eigenen Felder und meldet den Kontakt an.
  • Bestehender Abonnent, der sich abgemeldet hatte: Emailit meldet ihn erneut an.
  • Bestehender, angemeldeter Abonnent: Es ändert sich nichts, und die Antwort ist trotzdem 200.

Mit aktiviertem Double-Opt-in wird ein neuer Kontakt sofort angelegt, Namen und eigene Felder eines bestehenden Kontakts werden nicht geändert, und die Anmeldung wartet, bis die Person auf den Link in der Double-Opt-in-E-Mail klickt.

Eine neue Anmeldung sendet die Webhook-Events subscriber.created (bzw. subscriber.updated bei einer erneuten Anmeldung), startet Automatisierungen mit dem Trigger Added to audience und sendet die Anmeldebestätigung der Kontaktliste, wenn sie aktiviert ist. Anmeldungen senden keine contact.*-Events und ändern nicht den Marketing-Status eines Kontakts: War der Kontakt global abgemeldet, überspringen Kampagnen ihn weiterhin, bis Sie ihn auf der Seite Contacts erneut anmelden.

Anmeldeformular anbinden

Die Anmelde-URL hat keinen Bot-Schutz und akzeptiert nur JSON. Am sichersten ist es, Ihr Formular an Ihren eigenen Server zu senden, es dort zu prüfen und die Anmelde-URL vom Server aus aufzurufen. So bleibt das Token aus Ihrem Seitenquelltext heraus, und Sie können Spam blockieren, bevor er Ihre Kontaktliste erreicht.

  1. Formular in Ihre Seite einbauen. Senden Sie es an einen Endpunkt auf Ihrer eigenen Website. Das versteckte Feld website ist ein Honeypot: Menschen sehen es nicht, Bots füllen es aber oft aus.

    signup.html
    <form id="signup" method="post" action="/newsletter">
      <label for="email">Email</label>
      <input id="email" name="email" type="email" required>
    
      <label for="first_name">First name</label>
      <input id="first_name" name="first_name" type="text">
    
      <!-- Honeypot: hidden from people, often filled in by bots -->
      <div style="position:absolute;left:-10000px" aria-hidden="true">
        <input name="website" type="text" tabindex="-1" autocomplete="off">
      </div>
    
      <button type="submit">Subscribe</button>
      <p class="status" role="status"></p>
    </form>
  2. Formular auf Ihrem Server verarbeiten. Verwerfen Sie Honeypot-Treffer, prüfen Sie ein CAPTCHA, falls Sie eines verwenden, und leiten Sie die Felder dann als JSON an die Anmelde-URL weiter. Bewahren Sie das Token in einer Umgebungsvariable wie EMAILIT_SUBSCRIBE_TOKEN auf. Siehe die Serverbeispiele unten.

  3. Testen. Senden Sie das Formular mit Ihrer eigenen Adresse ab und prüfen Sie, ob Sie in der Abonnententabelle der Kontaktliste erscheinen.

Serverbeispiele

server.js
import express from 'express';

const app = express();

app.post('/newsletter', express.urlencoded({ extended: false }), async (req, res) => {
  // Bots fill in the honeypot. Pretend it worked and stop.
  if (req.body.website) return res.redirect(303, '/thanks');

  const response = await fetch(
    `https://api.emailit.com/subscribe/${process.env.EMAILIT_SUBSCRIBE_TOKEN}`,
    {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        email: req.body.email,
        first_name: req.body.first_name || undefined,
      }),
    },
  );

  if (!response.ok) {
    const { error } = await response.json().catch(() => ({}));
    return res.status(response.status).send(error || 'Could not subscribe.');
  }

  res.redirect(303, '/thanks');
});

app.listen(3000);

Wenn Ihre Seite per JavaScript statt mit einem vollständigen Seitenaufruf sendet, rufen Sie mit fetch Ihren eigenen Endpunkt auf und belassen den Aufruf an Emailit auf dem Server:

signup.js
document.querySelector('#signup').addEventListener('submit', async (event) => {
  event.preventDefault();
  const form = new FormData(event.target);
  const response = await fetch('/newsletter', { method: 'POST', body: new URLSearchParams(form) });
  event.target.querySelector('.status').textContent = response.ok
    ? 'Thanks, you are subscribed.'
    : 'Something went wrong. Please try again.';
});

Rate Limit und höhere Volumen

Die Anmelde-URL akzeptiert 30 Anfragen pro Minute von jeder IP-Adresse und gibt darüber 429 zurück. Wenn Ihr Server jede Anmeldung weiterleitet, kommen alle von der IP Ihres Servers; die 30 pro Minute gelten dann also für Ihre gesamte Website. Wenn Double-Opt-in oder die Anmeldebestätigung aktiviert ist, gelten für Anmeldungen außerdem Fair-Use-Limits pro Kontaktliste und pro Netzwerk, weil jede Anmeldung eine E-Mail sendet. Erwarten Sie mehr, rufen Sie stattdessen Abonnent hinzufügen mit einem API-Schlüssel von Ihrem Server aus auf. Dieser Endpunkt gibt außerdem 409 für bereits angemeldete Personen zurück und akzeptiert "double_opt_in": true, um eine Bestätigung anzufordern.

Anmeldungen bestätigen

Aktivieren Sie Double-Opt-in im Tab Settings der Kontaktliste, damit jede Person, die sich über die Anmelde-URL anmeldet, zuerst ihre Adresse bestätigt. Die URL gibt dann 202 zurück, Emailit sendet die Double-Opt-in-E-Mail von Ihrer verifizierten Domain, und die Person wird angemeldet, wenn sie auf den Link darin klickt. Ihr Formular kann „Prüfen Sie Ihr Postfach“ anzeigen, wenn es 202 erhält.

Um Personen zu begrüßen, sobald sie auf der Liste stehen, aktivieren Sie die Anmeldebestätigung der Kontaktliste.

URL zurücksetzen

Setzen Sie das Token zurück, wenn die URL bekannt geworden ist oder Sie Spam-Anmeldungen erhalten. Die alte URL funktioniert sofort nicht mehr und gibt 404 zurück.

  1. Dialog öffnen. Wählen Sie auf der Seite der Kontaktliste Subscribe URL.

  2. Zurücksetzen. Wählen Sie Reset token und bestätigen Sie. Emailit erzeugt eine neue URL.

  3. Integrationen aktualisieren. Ersetzen Sie das Token überall, wo Sie es verwenden, etwa in der Variable EMAILIT_SUBSCRIBE_TOKEN auf Ihrem Server.

Das Token lässt sich nur in der Weboberfläche zurücksetzen.

Personen per API hinzufügen und erneute Anmeldungen handhaben.
Personen Ihre Kontaktlisten verlassen lassen.

War diese Seite hilfreich?

Danke für Ihr Feedback.

Danke, wir lesen jede Nachricht.