Wie starte ich einen Flow via API-Call?

Last updated: December 3, 2025

Um einen Flow über einen API-Call zu starten, benötigst du Admin-Rechte in deinem PastaHR-Workspace.

1. Flow auswählen und Vorlage festlegen

  1. Gehe im PastaHR-Workspace in der linken Seitenleiste auf Einstellungen > Flows.

  2. Wähle den gewünschten Flow aus und klicke auf Bearbeiten.

  3. Gehe im Flow auf den Tab Einstellungen.

  4. Unter Flow-Vorlage auswählen:

    • Wähle die Vorlage aus, die an Kandidat:innen gesendet wird, wenn der Flow über den Chat oder per API-Call gestartet wird.

    • Die Vorlagen werden von PastaHR bereitgestellt.
      Falls ihr zusätzliche Templates benötigt, kontaktiert support@pastahr.com.

2. API-Endpunkt einrichten

  1. Klicke im Flow auf API-Token verwalten.

  2. In dieser Ansicht findest du:

  • Die URL für den POST-Request

  • Die Form des Request-Body, der die Plattform und das Kandidaten-Objekt (z. B. Telefonnummer) enthält.

  • Beispiel für Payload Struktur

    {
  "platform": "whatsapp",
  "candidate": {
    "phoneNumber": "+1234567890"
  }
}

3. API-Authentifizierung

  • Alle API-Anfragen müssen authentifiziert werden.

  • Füge im Header deiner Anfrage den flow-spezifischen Bearer-Token hinzu:

    Authorization: Bearer <access_token>

  • Um ein Token zu generieren:

    1. Klicke auf API-Token generieren.

    2. Unter Aktive Token siehst du eine Übersicht aller generierten Tokens.

    3. Hier kannst du Tokens auch wieder entfernen.

  • Wichtig: Sobald ein Token geniert wurde, kann es nur einmal kopiert werden. Danach wird es nicht mehr angezeigt.