Zapier-integration

Anslut Working Timer till tusentals appar via Zapier. Du kan till exempel skapa en arbetspost från en kalenderhändelse, ett formulär, en kalkylbladsrad eller en slutförd uppgift.

Integrationen använder Working Timers publika API. Du behöver inte dela ditt Working Timer-lösenord med Zapier.

Det här behöver du

• Ett Working Timer-konto med en aktiv Public API-plan eller provperiod
• En betald Zapier-plan med API by Zapier eller Webhooks by Zapier
• ID:t för den Working Timer-profil som ska ta emot posterna

Viktigt: Behandla API-nyckeln som ett lösenord. Lägg den inte i Zap-namn, anteckningar, URL:er eller fält som kan visas i aktivitetshistoriken.

1. Skapa en API-nyckel

1. Öppna Working Timer API-portalen, välj Sign In och logga in.
2. Välj New Key under API Keys i API Dashboard.
3. Ange ett namn, till exempel Zapier, och välj Create.
4. Kopiera omedelbart nyckeln som börjar med wt_ak_. Den visas bara en gång.

Om du tappar bort den måste du återkalla den och skapa en ny.

2. Hitta profil-ID

1. Öppna API-referensen.
2. Välj Authorize och ange nyckeln i fältet ApiKey.
3. Öppna GET /api/v1/Profile, välj Try it out och sedan Execute.
4. Hitta profilen i svaret och kopiera dess id.

ID:t är ett GUID som liknar a1b2c3d4-1234-5678-9abc-1234567890ab.

3. Anslut med API by Zapier

1. Öppna Apps i Zapier, välj Add connection och sedan API by Zapier.
2. Välj Static Headers (API key) som Authentication type.
3. Lägg till en rad under Headers:

X-Api-Key: wt_ak_din_api_nyckel

4. Ange Working Timer som Connection name.
5. Ange api.workingtimer.com som Domain filter.
6. Ange https://api.workingtimer.com/api/v1/Profile?pageSize=1 som Test URL.
7. Välj Yes, Continue to API by Zapier.

API by Zapier är en betafunktion. Använd Webhooks-metoden nedan om den inte är tillgänglig.

4. Skapa din första Zap

1. Skapa en Zap och välj en utlösare, exempelvis en ny händelse, uppgift, blankett eller rad.
2. Lägg till API by Zapier, välj API Request och anslutningen Working Timer.
3. Ange Method POST och URL https://api.workingtimer.com/api/v1/WorkRecord.
4. Ange följande under Body:

{
  "profileId": "DITT_PROFIL_ID",
  "year": 2026,
  "month": 7,
  "day": 31,
  "clockIn": 540,
  "clockOut": 1020,
  "breakMinutes": 30,
  "recordType": "common",
  "isPaid": true,
  "note": "Skapad av Zapier"
}

5. Ersätt DITT_PROFIL_ID, mappa värden från utlösaren och konvertera dem vid behov först med Formatter by Zapier.
6. Välj Test step. En lyckad begäran returnerar 201. Kontrollera posten i Working Timer och publicera din Zap.

clockIn och clockOut är minuter efter midnatt: 08:00 = 480, 09:00 = 540, 17:00 = 1020. För nattpass kan clockOut vara större än 1440.

Alternativ: Webhooks by Zapier

Lägg till Webhooks by Zapier med händelsen POST. Ange URL https://api.workingtimer.com/api/v1/WorkRecord, Payload Type JSON, uppgifterna ovan samt headers X-Api-Key med din nyckel och Content-Type med application/json. Ett lyckat test returnerar 201.

Andra användbara begäranden

• Profiler: GET https://api.workingtimer.com/api/v1/Profile
• Poster: GET https://api.workingtimer.com/api/v1/WorkRecord
• Uppdatera: PATCH https://api.workingtimer.com/api/v1/WorkRecord/{id}
• Ta bort: DELETE https://api.workingtimer.com/api/v1/WorkRecord/{id}

Fler endpoints finns i API-referensen.

Felsökning

• 401 Unauthorized — nyckeln saknas, är ofullständig eller återkallad. Headern måste heta exakt X-Api-Key.
• 403 Forbidden — aktivera eller förnya Public API-planen eller provperioden.
• 400 Bad Request — kontrollera JSON, datum och numeriska minutvärden.
• Profile was not found — kontrollera att profileId tillhör samma konto.
• 429 Too Many Requests — en API-gräns har nåtts; försök senare och kontrollera användningen.
• Dubbletter — granska Zapier-historiken och använd ett filter eller unikt käll-ID före åtgärden.

Återkalla åtkomsten genom att välja Revoke för Zapier-nyckeln i API Dashboard.