Zapier-Integration

Einführung Erste Schritte Timer — Arbeitszeiterfassung Dashboard Monatstabelle Jahresstatistik Einträge hinzufügen und bearbeiten Projekte Aktivitäten Vorlagen Profil- und Lohneinstellungen Export und Arbeitsberichte Geofencing App-Einstellungen Synchronisation und Backups Kiosk-Modus (Terminal) Benachrichtigungen & Erinnerungen Arbeitsanträge Dateien & Speicher Premium & Abonnements Zapier-Integration

Zapier-Integration

Verbinden Sie Working Timer über Zapier mit Tausenden von Apps. So können Sie beispielsweise aus einem Kalendertermin, Formular, Tabellenblatt oder erledigten Task automatisch einen Arbeitszeiteintrag erstellen.

Die Integration verwendet die öffentliche Working Timer API. Ihr Working-Timer-Passwort müssen Sie nicht mit Zapier teilen.

Voraussetzungen

  • Ein Working-Timer-Konto mit aktivem Public-API-Tarif oder Testzeitraum
  • Ein kostenpflichtiger Zapier-Tarif mit API by Zapier oder Webhooks by Zapier
  • Die ID des Working-Timer-Profils, dem die Einträge zugeordnet werden

Wichtig: Behandeln Sie den API-Schlüssel wie ein Passwort. Tragen Sie ihn nicht in Zap-Namen, Notizen, URLs oder andere Felder ein, die im Aufgabenverlauf erscheinen können.

1. API-Schlüssel erstellen

  1. Öffnen Sie das Working Timer API-Portal, wählen Sie Sign In und melden Sie sich an.
  2. Wählen Sie im API Dashboard unter API Keys die Option New Key.
  3. Geben Sie einen Namen wie Zapier ein und wählen Sie Create.
  4. Kopieren Sie den mit wt_ak_ beginnenden Schlüssel sofort. Er wird nur einmal angezeigt.

Bei Verlust müssen Sie den Schlüssel widerrufen und einen neuen erstellen.

2. Profil-ID ermitteln

  1. Öffnen Sie die API-Referenz.
  2. Wählen Sie Authorize und geben Sie den Schlüssel im Feld ApiKey ein.
  3. Öffnen Sie GET /api/v1/Profile, wählen Sie Try it out und danach Execute.
  4. Suchen Sie das gewünschte Profil in der Antwort und kopieren Sie dessen id.

Die Profil-ID ist eine GUID wie a1b2c3d4-1234-5678-9abc-1234567890ab.

3. Verbindung mit API by Zapier

  1. Öffnen Sie in Zapier Apps, wählen Sie Add connection und anschließend API by Zapier.
  2. Wählen Sie als Authentication type die Option Static Headers (API key).
  3. Tragen Sie unter Headers eine Zeile ein:
X-Api-Key: wt_ak_ihr_api_schluessel
  1. Verwenden Sie Working Timer als Connection name.
  2. Setzen Sie den Domain filter auf api.workingtimer.com.
  3. Verwenden Sie als Test URL https://api.workingtimer.com/api/v1/Profile?pageSize=1.
  4. Wählen Sie Yes, Continue to API by Zapier.

API by Zapier befindet sich in der Beta-Phase. Falls es für Ihr Konto nicht verfügbar ist, verwenden Sie die Webhooks-Methode weiter unten.

4. Ersten Zap erstellen

  1. Erstellen Sie einen Zap und wählen Sie einen Auslöser, etwa einen neuen Termin, Task, Formulareintrag oder eine Tabellenzeile.
  2. Fügen Sie API by Zapier mit der Aktion API Request hinzu und wählen Sie die Verbindung Working Timer.
  3. Setzen Sie Method auf POST und URL auf https://api.workingtimer.com/api/v1/WorkRecord.
  4. Tragen Sie unter Body Folgendes ein:
{
  "profileId": "IHRE_PROFIL_ID",
  "year": 2026,
  "month": 7,
  "day": 31,
  "clockIn": 540,
  "clockOut": 1020,
  "breakMinutes": 30,
  "recordType": "common",
  "isPaid": true,
  "note": "Von Zapier erstellt"
}
  1. Ersetzen Sie IHRE_PROFIL_ID, ordnen Sie Werte aus dem Auslöser zu und wandeln Sie diese bei Bedarf vorher mit Formatter by Zapier um.
  2. Wählen Sie Test step. Eine erfolgreiche Anfrage liefert den Status 201. Prüfen Sie den Eintrag in Working Timer und veröffentlichen Sie den Zap.

clockIn und clockOut sind Minuten seit Mitternacht: 08:00 = 480, 09:00 = 540, 17:00 = 1020. Bei Nachtschichten darf clockOut größer als 1440 sein.

Alternative: Webhooks by Zapier

Fügen Sie Webhooks by Zapier mit dem Ereignis POST hinzu. Verwenden Sie die URL https://api.workingtimer.com/api/v1/WorkRecord, den Payload Type JSON, die oben gezeigten Daten sowie die Header X-Api-Key mit Ihrem Schlüssel und Content-Type mit application/json. Ein erfolgreicher Test liefert 201.

Weitere nützliche Anfragen

  • Profile: GET https://api.workingtimer.com/api/v1/Profile
  • Arbeitszeiteinträge: GET https://api.workingtimer.com/api/v1/WorkRecord
  • Aktualisieren: PATCH https://api.workingtimer.com/api/v1/WorkRecord/{id}
  • Löschen: DELETE https://api.workingtimer.com/api/v1/WorkRecord/{id}

Weitere Endpunkte finden Sie in der API-Referenz.

Fehlerbehebung

  • 401 Unauthorized — der Schlüssel fehlt, ist unvollständig oder wurde widerrufen. Der Header muss exakt X-Api-Key heißen.
  • 403 Forbidden — aktivieren oder verlängern Sie den Public-API-Tarif bzw. Testzeitraum.
  • 400 Bad Request — prüfen Sie JSON, Datum und numerische Minutenwerte.
  • Profile was not found — prüfen Sie, ob profileId zum selben Konto gehört.
  • 429 Too Many Requests — das API-Limit wurde erreicht; versuchen Sie es später erneut und prüfen Sie die Nutzung.
  • Doppelte Einträge — prüfen Sie den Zapier-Aufgabenverlauf und verwenden Sie vor der Aktion einen Filter oder eine eindeutige Quell-ID.

Um den Zugriff zu beenden, wählen Sie im API Dashboard beim Zapier-Schlüssel Revoke.

Zurück Premium & Abonnements