Wenn du Schwierigkeiten bei der Übergabe von Antworten an externe Tools wie Airtable, HubSpot oder Zapier hast, findest du hier typische Fehlerursachen und wie du sie ganz einfach beheben kannst.
Fehler: „Cannot find access token for user“
Beschreibung:
Das ist ein Authentifizierungsfehler. Meistens fehlt der OAuth-Token, der notwendig ist, um Heyflow mit einem Drittanbieter-Tool (wie HubSpot oder Airtable) zu verbinden – oder der Token ist abgelaufen.
Lösung:
Öffne in deinem Heyflow-Account den Bereich Integrationen und verbinde die Integration erneut.
Stelle sicher, dass der Nutzer, der die Integration ursprünglich autorisiert hat, weiterhin gültigen Zugriff hat.
So autorisierst du eine Drittanbieter-Integration neu
Wenn du die Fehlermeldung „Cannot find access token for user“ erhältst, bedeutet das meistens, dass der Authentifizierungs-Token abgelaufen oder ungültig ist.
So stellst du die Verbindung wieder her:
Gehe in deinem Heyflow-Konto zum Tab Integrationen.
Wähle die entsprechende Integration aus und klicke auf Konten verwalten.
Es öffnet sich ein Pop-up. Klicke hier auf Neu verbinden.
Fertig! Neue Antworten werden jetzt wieder korrekt übermittelt.
Mit diesem Vorgang wird der Token aktualisiert und die Verbindung zum Drittanbieter wiederhergestellt.
Fehler: "VALIDATION_ERROR: Property values were not valid"
Beschreibung:
Die übermittelten Werte aus Heyflow entsprechen nicht dem erwarteten Format oder Inhalt im Zielsystem (z. B. HubSpot). Häufige Ursachen sind:
Optionswerte stimmen nicht überein
Bei Dropdowns oder Mehrfachauswahlfeldern muss das Label in Heyflow exakt dem internen Wert im Zielsystem entsprechen – inklusive Groß- und Kleinschreibung.
Textfeld statt Zahlenfeld
Stelle sicher, dass Zahlenfelder auch wirklich nur Zahlen enthalten. In Heyflow kannst du das so einstellen:
Wähle das entsprechende Eingabefeld in deinem Flow aus.
Scrolle in der linken Seitenleiste nach unten zum Bereich Erweitert.
Aktiviere dort unter Natives Eingabeformat die Option number.
Damit werden nur numerische Werte akzeptiert – und Formatfehler im Zielsystem vermieden.
E-Mail-Format ist ungültig
Die eingegebene E-Mail-Adresse entspricht nicht dem erwarteten Format? Kein Problem – das lässt sich absichern:
Wähle das E-Mail-Eingabefeld in deinem Flow.
Scrolle in der linken Seitenleiste zum Bereich Validierung.
Aktiviere das Kästchen E-Mail-Format erzwingen.
Damit wird sichergestellt, dass Nutzer nur korrekt formatierte E-Mails eingeben können.
Beispiel-Fehlermeldung:
VALIDATION_ERROR: Property values were not valid:[{"isValid":false,"message":"Email address [email protected] is invalid","error":"INVALID_EMAIL","name":"email"}]
Lösung:
Achte auf exakte Übereinstimmung der Eingabewerte mit dem Zielsystem.
Für E-Mails: Aktiviere im Bereich Dekoratoren die Option Leerzeichen automatisch entfernen.
Veröffentliche deinen Flow neu und teste danach erneut.
Allgemeine Empfehlungen
Stelle sicher, dass die Feldzuordnungen in Heyflow exakt den Erwartungen des Zielsystems entsprechen.
Nutze Validierungsfunktionen wie Leerzeichen automatisch entfernen, wo sinnvoll.
Authentifiziere Integrationen regelmäßig neu, um Token-Probleme zu vermeiden.
Weitere Fehlermeldungen
Manche Integrationen funktionieren etwas anders als die in diesem Guide genannten (z. B. HubSpot oder Airtable). Wenn du eine spezifische Integration verwendest und eine andere Fehlermeldung erhältst, findest du hier weiterführende Hilfe: