Zum Hauptinhalt springen
POST
Kontaktereignisse abonnieren
Verwende diesen Endpunkt für einen Zapier-REST-Hook-Trigger. Wenn du einen Zap ohne eigenen Code einrichten möchtest, folge Tapify mit Zapier verbinden. Sende contact.created oder contact.updated als eventType zusammen mit der von Zapier bereitgestellten targetUrl.
Das Ziel muss eine HTTPS-URL auf hooks.zapier.com sein, ohne Benutzernamen, Passwort oder URL-Fragment. Dieser Endpunkt akzeptiert ausschließlich Zapier-Hooks.

Abonnement-ID speichern

Die Antwort ist ein Objekt mit id, ohne umschließendes data-Objekt. Speichere diese ID, um das Abonnement später zu entfernen. Wenn du die Anfrage mit demselben Workspace, Eventtyp und derselben URL wiederholst, erhältst du die bestehende Abonnement-ID. Das Abonnement wird dabei dem API-Schlüssel zugeordnet, den du für die Anfrage verwendest.

Eventdaten

Tapify sendet ein Kontaktobjekt direkt an den Zapier-Hook, wenn das gewählte Event eintritt. Das Objekt enthält weder ein umschließendes data-Objekt noch ein Feld eventType.
  • Neuer Kontakt: id ist die Kontakt-ID.
  • Aktualisierter Kontakt: id kombiniert Kontakt-ID und Änderungszeitpunkt. contactId enthält die ursprüngliche Kontakt-ID für andere API-Anfragen.
Kontaktdaten können interne Notizen und übermittelte Nachrichten enthalten. Sende sie nur an einen Zapier-Workflow, der auf diese Daten zugreifen darf.

Zustellung und Zugriff

Dein Workflow sollte wiederholte Zustellungen verarbeiten können. Bei vorübergehenden Fehlern kann Tapify die Zustellung erneut versuchen; sie ist jedoch nicht garantiert. Eine 410 Gone-Antwort von Zapier entfernt das Abonnement.
Wenn du den API-Schlüssel löschst, werden auch seine Abonnements entfernt. Verbinde die Workflows erneut oder registriere sie neu, wenn du einen Schlüssel ersetzt. Der Workspace benötigt auch für die Zustellung Teams Connect.

Autorisierungen

Authorization
string
header
erforderlich

Unter Einstellungen → API-Schlüssel erstellter API-Schlüssel.

Body

application/json
eventType
enum<string>
erforderlich

Das Tapify-Kontaktereignis, das dieser Zapier-Trigger verwendet.

Verfügbare Optionen:
contact.created,
contact.updated
targetUrl
string<uri>
erforderlich

Zapier-Ziel: eine HTTPS-URL auf hooks.zapier.com ohne Benutzername, Passwort oder Fragment.

Maximum string length: 2048
Beispiel:

"https://hooks.zapier.com/hooks/standard/123456/example/"

Antwort

Abonnement erstellt oder wiederverwendet. Die Antwort enthält keinen data-Wrapper.

Die Abonnement-ID, direkt und ohne data-Wrapper zurückgegeben.

id
string<uuid>
erforderlich

Speichere diese ID, um das Abonnement zu beenden.

Beispiel:

"1f84ece7-9acc-4abd-8ce1-925b2a5df17d"