Intégration Zapier

Intégration Zapier

Connectez Working Timer à des milliers d'applications avec Zapier. Vous pouvez, par exemple, créer une entrée de travail à partir d'un événement de calendrier, d'un formulaire, d'une ligne de feuille de calcul ou d'une tâche terminée.

L'intégration utilise l'API publique Working Timer. Vous n'avez pas à communiquer votre mot de passe Working Timer à Zapier.

Prérequis

  • Un compte Working Timer avec un abonnement ou un essai Public API actif
  • Un abonnement Zapier payant incluant API by Zapier ou Webhooks by Zapier
  • L'ID du profil Working Timer qui recevra les entrées

Important : Traitez la clé API comme un mot de passe. Ne la placez pas dans le nom, les notes, l'URL ou un champ du Zap susceptible d'apparaître dans l'historique.

1. Créer une clé API

  1. Ouvrez le portail API Working Timer, sélectionnez Sign In et connectez-vous.
  2. Dans API Dashboard, sous API Keys, sélectionnez New Key.
  3. Saisissez un nom comme Zapier, puis sélectionnez Create.
  4. Copiez immédiatement la clé commençant par wt_ak_. Elle ne s'affiche qu'une fois.

Si vous la perdez, révoquez-la et créez-en une nouvelle.

2. Trouver l'ID du profil

  1. Ouvrez la référence API.
  2. Sélectionnez Authorize et saisissez la clé dans le champ ApiKey.
  3. Ouvrez GET /api/v1/Profile, sélectionnez Try it out, puis Execute.
  4. Repérez le profil dans la réponse et copiez son id.

L'ID est un GUID semblable à a1b2c3d4-1234-5678-9abc-1234567890ab.

3. Connecter API by Zapier

  1. Dans Zapier, ouvrez Apps, sélectionnez Add connection, puis API by Zapier.
  2. Pour Authentication type, choisissez Static Headers (API key).
  3. Dans Headers, ajoutez une ligne :
X-Api-Key: wt_ak_votre_cle_api
  1. Définissez Connection name sur Working Timer.
  2. Définissez Domain filter sur api.workingtimer.com.
  3. Utilisez comme Test URL https://api.workingtimer.com/api/v1/Profile?pageSize=1.
  4. Sélectionnez Yes, Continue to API by Zapier.

API by Zapier est actuellement en version bêta. Si cette option n'est pas disponible, utilisez la méthode Webhooks ci-dessous.

4. Créer votre premier Zap

  1. Créez un Zap et choisissez un déclencheur : nouvel événement, tâche, formulaire ou ligne de feuille, par exemple.
  2. Ajoutez API by Zapier, choisissez l'action API Request, puis la connexion Working Timer.
  3. Définissez Method sur POST et URL sur https://api.workingtimer.com/api/v1/WorkRecord.
  4. Saisissez dans Body :
{
  "profileId": "ID_DU_PROFIL",
  "year": 2026,
  "month": 7,
  "day": 31,
  "clockIn": 540,
  "clockOut": 1020,
  "breakMinutes": 30,
  "recordType": "common",
  "isPaid": true,
  "note": "Créé par Zapier"
}
  1. Remplacez ID_DU_PROFIL, associez les valeurs du déclencheur et utilisez d'abord Formatter by Zapier si une conversion est nécessaire.
  2. Sélectionnez Test step. Une requête réussie renvoie 201. Vérifiez l'entrée dans Working Timer, puis publiez le Zap.

clockIn et clockOut sont des minutes depuis minuit : 08:00 = 480, 09:00 = 540, 17:00 = 1020. Pour un service de nuit, clockOut peut dépasser 1440.

Alternative : Webhooks by Zapier

Ajoutez Webhooks by Zapier avec l'événement POST. Définissez l'URL sur https://api.workingtimer.com/api/v1/WorkRecord, Payload Type sur JSON, ajoutez les données ci-dessus et les en-têtes X-Api-Key avec votre clé et Content-Type avec application/json. Un test réussi renvoie 201.

Autres requêtes utiles

  • Profils : GET https://api.workingtimer.com/api/v1/Profile
  • Entrées : GET https://api.workingtimer.com/api/v1/WorkRecord
  • Mise à jour : PATCH https://api.workingtimer.com/api/v1/WorkRecord/{id}
  • Suppression : DELETE https://api.workingtimer.com/api/v1/WorkRecord/{id}

Consultez la référence API pour les autres endpoints.

Dépannage

  • 401 Unauthorized — la clé est absente, incomplète ou révoquée. L'en-tête doit être exactement X-Api-Key.
  • 403 Forbidden — activez ou renouvelez l'abonnement ou l'essai Public API.
  • 400 Bad Request — vérifiez le JSON, la date et les valeurs numériques en minutes.
  • Profile was not found — vérifiez que profileId appartient au même compte.
  • 429 Too Many Requests — une limite API est atteinte ; réessayez plus tard et consultez l'utilisation.
  • Entrées en double — consultez l'historique Zapier et utilisez un filtre ou un ID source unique avant l'action.

Pour retirer l'accès, sélectionnez Revoke pour la clé Zapier dans API Dashboard.