Webhooks

In Growth und Ultimate sendet Letlink per POST JSON an jede HTTPS-URL, die im Workspace registriert ist, sobald ein Klick erfasst wird. Inhaber und Admins fügen URLs unter Integrationen → Webhooks hinzu oder entfernen sie. Mitglieder sehen die Liste, können sie aber nicht ändern.

Endpoint hinzufügen

1. Richte eine HTTPS-URL ein, die POST mit Content-Type: application/json annimmt. HTTP wird abgelehnt.
2. Füge sie unter Integrationen → Webhooks ein und speichere. Der Event-Name ist link_visited.
3. Klicke einen deiner Kurzlinks an (aus einem Netzwerk, das nicht über dem monatlichen Limit liegt). Innerhalb weniger Sekunden solltest du eine Anfrage sehen – die Zustellung läuft über eine Warteschlange, nicht direkt bei der Weiterleitung.

Du kannst auch über die API abonnieren: POST /api/v1/hooks/subscribe mit target_url und optional event (Standard: link_visited). Zapier REST Hooks nutzen genau dieses Routenpaar zum An- und Abmelden.

Payload

Der Body ist das kanonische Besuchsobjekt. Leere UTM- oder Store-Felder sind null.

{
  "visit_id": 42,
  "visit_time": "2026-09-09T18:01:22+00:00",
  "link_type": "utm",
  "link_shortcode": "summer",
  "link_domain": "letl.ink",
  "link_destination_url": "https://example.com/a",
  "utm_source": "newsletter",
  "utm_campaign": "sep",
  "utm_medium": "email",
  "google_play_app_url": null,
  "google_play_utm_source": null,
  "google_play_utm_campaign": null,
  "app_store_app_url": null,
  "app_store_ct": null,
  "instagram_username": null,
  "visitor_ip": "203.0.113.10",
  "visitor_browser": "Chrome",
  "visitor_device_type": "desktop",
  "visitor_referrer": "https://mail.example.com/",
  "visitor_variation": "hero-b"
}

Wenn ein Webhook nicht auslöst

• Der Workspace nutzt Free oder Solo (allowsWebhooks ist deaktiviert).
• Das monatliche Limit für erfasste Klicks ist bereits erreicht – die Weiterleitung erfolgt trotzdem, aber es wird keine Zeile geschrieben und daher nichts gesendet.
• Ein Besuchslimit pro Gerät hat 429 zurückgegeben, bevor ein Klick gespeichert wurde.
• Eine Länderzugriffsregel hat den Besucher abgewiesen. Blockierte Besuche werden nie als Klicks gespeichert.
• Die Ziel-URL ist nicht erreichbar. Die Zustellung erfolgt nach bestem Bemühen und darf den Besucher nie verzögern; fehlgeschlagene Posts werden von dieser Seite aus nicht erneut gesendet.

Wer was erhält

Hooks werden pro Nutzer gespeichert. Die link_visited-URLs jedes Mitglieds werden bei Klicks auf jeden Link im Workspace benachrichtigt. Wenn zwei Teammitglieder jeweils Zapier abonniert haben, laufen beide Zaps. Entferne ungenutzte URLs, damit kein übrig gebliebener Catch Hook weiter auslöst.