Zapier-integratie

Introductie Eerste stappen Timer — Werktijd bijhouden Dashboard Maandtabel Jaarstatistieken Registraties toevoegen en bewerken Projecten Activiteiten Sjablonen Profiel- en looninstellingen Export en werkrapporten Geofencing App-instellingen Synchronisatie en back-ups Kioskmodus (Terminal) Meldingen en herinneringen Werkaanvragen Bestanden & Opslag Premium & Abonnementen Zapier-integratie

Zapier-integratie

Koppel Working Timer via Zapier aan duizenden apps. Maak bijvoorbeeld automatisch een werkregistratie vanuit een agenda-afspraak, formulier, spreadsheetrij of voltooide taak.

De integratie gebruikt de openbare API van Working Timer. Je hoeft je Working Timer-wachtwoord niet met Zapier te delen.

Benodigdheden

  • Een Working Timer-account met een actief Public API-abonnement of proefperiode
  • Een betaald Zapier-abonnement met API by Zapier of Webhooks by Zapier
  • De ID van het Working Timer-profiel waarin registraties worden opgeslagen

Belangrijk: Behandel de API-sleutel als een wachtwoord. Plaats hem niet in een Zap-naam, notitie, URL of veld dat in de taakgeschiedenis kan verschijnen.

1. Een API-sleutel maken

  1. Open het Working Timer API-portaal, kies Sign In en meld je aan.
  2. Kies in API Dashboard onder API Keys voor New Key.
  3. Voer een naam zoals Zapier in en kies Create.
  4. Kopieer de sleutel die met wt_ak_ begint direct. Hij wordt maar één keer getoond.

Raak je hem kwijt, trek hem dan in en maak een nieuwe.

2. De profiel-ID vinden

  1. Open de API-referentie.
  2. Kies Authorize en voer de sleutel in bij ApiKey.
  3. Open GET /api/v1/Profile, kies Try it out en daarna Execute.
  4. Zoek het profiel in het antwoord en kopieer de id.

De ID is een GUID zoals a1b2c3d4-1234-5678-9abc-1234567890ab.

3. Verbinden met API by Zapier

  1. Open in Zapier Apps, kies Add connection en vervolgens API by Zapier.
  2. Kies bij Authentication type voor Static Headers (API key).
  3. Voeg bij Headers één regel toe:
X-Api-Key: wt_ak_jouw_api_sleutel
  1. Stel Connection name in op Working Timer.
  2. Stel Domain filter in op api.workingtimer.com.
  3. Gebruik als Test URL https://api.workingtimer.com/api/v1/Profile?pageSize=1.
  4. Kies Yes, Continue to API by Zapier.

API by Zapier is een bètafunctie. Gebruik de Webhooks-methode hieronder als deze niet beschikbaar is.

4. Je eerste Zap maken

  1. Maak een Zap en kies een trigger, zoals een nieuwe afspraak, taak, formulierinzending of rij.
  2. Voeg API by Zapier toe, kies API Request en de verbinding Working Timer.
  3. Stel Method in op POST en URL op https://api.workingtimer.com/api/v1/WorkRecord.
  4. Vul bij Body in:
{
  "profileId": "JOUW_PROFIEL_ID",
  "year": 2026,
  "month": 7,
  "day": 31,
  "clockIn": 540,
  "clockOut": 1020,
  "breakMinutes": 30,
  "recordType": "common",
  "isPaid": true,
  "note": "Gemaakt door Zapier"
}
  1. Vervang JOUW_PROFIEL_ID, koppel waarden uit de trigger en zet ze zo nodig eerst om met Formatter by Zapier.
  2. Kies Test step. Een geslaagd verzoek geeft status 201. Controleer de registratie in Working Timer en publiceer de Zap.

clockIn en clockOut zijn minuten sinds middernacht: 08:00 = 480, 09:00 = 540, 17:00 = 1020. Bij nachtdiensten mag clockOut hoger zijn dan 1440.

Alternatief: Webhooks by Zapier

Voeg Webhooks by Zapier toe met gebeurtenis POST. Stel de URL in op https://api.workingtimer.com/api/v1/WorkRecord, Payload Type op JSON, voeg bovenstaande gegevens toe en gebruik headers X-Api-Key met je sleutel en Content-Type met application/json. Een geslaagde test geeft 201.

Andere nuttige verzoeken

  • Profielen: GET https://api.workingtimer.com/api/v1/Profile
  • Registraties: GET https://api.workingtimer.com/api/v1/WorkRecord
  • Bijwerken: PATCH https://api.workingtimer.com/api/v1/WorkRecord/{id}
  • Verwijderen: DELETE https://api.workingtimer.com/api/v1/WorkRecord/{id}

Bekijk de API-referentie voor meer endpoints.

Problemen oplossen

  • 401 Unauthorized — de sleutel ontbreekt, is onvolledig of ingetrokken. De header moet exact X-Api-Key heten.
  • 403 Forbidden — activeer of verleng het Public API-abonnement of de proefperiode.
  • 400 Bad Request — controleer JSON, datum en numerieke minuutwaarden.
  • Profile was not found — controleer of profileId bij hetzelfde account hoort.
  • 429 Too Many Requests — een API-limiet is bereikt; probeer later opnieuw en controleer het gebruik.
  • Dubbele registraties — bekijk de Zapier-taakgeschiedenis en gebruik vóór de actie een filter of unieke bron-ID.

Kies in API Dashboard bij de Zapier-sleutel Revoke om de toegang in te trekken.

Vorige Premium & Abonnementen