# Fiche connecteur Harvest
Catalogue Pipedream : connexion du compte et droits nécessaires. Les actions réellement utilisables sont vérifiées dans Bruno lors de la connexion. Les déclencheurs sont documentés à titre de référence et ne sont pas activés automatiquement dans Bruno.
Les noms et données des exemples sont fictifs ; toute exécution reste soumise aux droits et aux validations du connecteur.

## Harvest
URL : https://get-bruno.com/features/connectors/harvest
Référence texte : https://get-bruno.com/features/connectors/harvest/reference.txt
Origine : Catalogue Pipedream
Statut : Catalogue Pipedream — connexion à vérifier
Catégories : Organisation du travail
Description : Harvest est un service de suivi du temps et de facturation en ligne. Il sert à gérer les clients, les projets, les tâches, les feuilles de temps, les utilisateurs et les factures d'un compte Harvest.
Authentification : OAuth
Présentation : Harvest est un service de suivi du temps et de facturation en ligne. Il sert à gérer les clients, les projets, les tâches, les feuilles de temps, les utilisateurs et les factures d'un compte Harvest.
Usage : Lister les projets avant d'y rattacher une tâche
Exemple de demande : Je veux retrouver le projet Atelier Martin et vérifier ses informations avant d'y créer une affectation de tâche.
Résultat attendu : Je récupère les projets du compte, puis je repère le projet Atelier Martin avec son identifiant et ses paramètres utiles pour la suite.
À préciser : Nom du client ou du projet à retrouver ; Accès au compte Harvest où le projet existe ; Objectif métier : préparer une affectation de tâche ou une mise à jour
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/harvest/actions/get-projects
Usage : Contrôler le temps saisi sur une semaine
Exemple de demande : Je veux voir le total d'heures loggées sur le projet Catalogue printemps entre le 1er et le 7 septembre 2026.
Résultat attendu : J'obtiens un total d'heures agrégé pour la période choisie, groupé par le niveau demandé comme projets, clients, tâches ou équipe.
À préciser : Nom du projet, du client, de la tâche ou de l'équipe à résumer ; Plage de dates à vérifier ; Objectif métier : suivre le temps passé ou préparer une synthèse
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/harvest/actions/get-time-report
Usage : Créer une facture pour un client existant
Exemple de demande : Je veux créer une facture pour le client Atelier Martin avec la ligne Conseil atelier et un montant de 1200.
Résultat attendu : Une nouvelle facture est préparée pour ce client avec les lignes fournies et les informations de facturation saisies.
À préciser : Nom ou identifiant du client déjà présent dans Harvest ; Objet de la facture ; Lignes de facture avec description, quantité et prix unitaire ; Objectif métier : préparer une facture à valider
Nature : Exemple sous réserve de connexion et de droits
Sources de l’exemple : https://pipedream.com/apps/harvest/actions/create-invoice
Limites propres au service : Aucune action de scraping ni de contenu externe n'est fournie ici. Plusieurs opérations demandent d'abord de retrouver un identifiant de client, projet, tâche, utilisateur ou facture. L'entrée de temps dépend du mode du compte : durée ou horodatage ; le format attendu change selon ce réglage. La suppression est permanente pour les factures, projets, temps et utilisateurs concernés par l'opération.
Vocabulaire français : Créer une facture — Crée une nouvelle facture libre pour un client, avec des lignes détaillées à fournir sous forme de tableau JSON. (https://pipedream.com/apps/harvest/actions/create-invoice)
Vocabulaire français : Créer un projet — Crée un nouveau projet et permet de préciser le client, la facturation et le budget. (https://pipedream.com/apps/harvest/actions/create-project)
Vocabulaire français : Créer une affectation de tâche — Ajoute une tâche à un projet en reliant un identifiant de projet à un identifiant de tâche. (https://pipedream.com/apps/harvest/actions/create-task-assignment)
Vocabulaire français : Créer une entrée de temps — Crée une saisie de temps ; selon le mode du compte, on fournit soit des heures, soit des heures de début et de fin. (https://pipedream.com/apps/harvest/actions/create-timesheet-entry)
Vocabulaire français : Créer un utilisateur — Ajoute un nouvel utilisateur au compte Harvest avec ses informations de base. (https://pipedream.com/apps/harvest/actions/create-user)
Vocabulaire français : Créer une affectation utilisateur — Attribue un utilisateur à un projet pour l'y affecter. (https://pipedream.com/apps/harvest/actions/create-user-assignment)
Vocabulaire français : Supprimer une facture — Supprime définitivement une facture existante à partir de son identifiant. (https://pipedream.com/apps/harvest/actions/delete-invoice)
Vocabulaire français : Supprimer un projet — Supprime définitivement un projet et les temps et dépenses qui y sont rattachés, sans supprimer les factures. (https://pipedream.com/apps/harvest/actions/delete-project)
Vocabulaire français : Supprimer une affectation de tâche — Retire une tâche d'un projet si aucune entrée de temps n'y est liée. (https://pipedream.com/apps/harvest/actions/delete-task-assignment)
Vocabulaire français : Supprimer une entrée de temps — Supprime définitivement une saisie de temps existante. (https://pipedream.com/apps/harvest/actions/delete-time-entry)
Vocabulaire français : Supprimer un utilisateur — Supprime définitivement un utilisateur si aucune donnée de temps ou de dépenses ne lui est liée. (https://pipedream.com/apps/harvest/actions/delete-user)
Vocabulaire français : Supprimer une affectation utilisateur — Retire un utilisateur d'un projet si aucune donnée de temps ou de dépenses n'est liée à cette affectation. (https://pipedream.com/apps/harvest/actions/delete-user-assignment)
Vocabulaire français : Obtenir une facture — Récupère une facture précise à partir de son identifiant. (https://pipedream.com/apps/harvest/actions/get-invoice)
Vocabulaire français : Obtenir l'utilisateur connecté — Récupère l'utilisateur actuellement authentifié sans demander d'identifiant. (https://pipedream.com/apps/harvest/actions/get-me)
Vocabulaire français : Obtenir un projet — Récupère un projet précis et ses informations de client, budget et méthode de facturation. (https://pipedream.com/apps/harvest/actions/get-project)
Vocabulaire français : Lister les projets — Liste un ou plusieurs projets du compte et sert aussi à découvrir les identifiants nécessaires aux autres opérations. (https://pipedream.com/apps/harvest/actions/get-projects)
Vocabulaire français : Obtenir une affectation de tâche — Récupère une affectation de tâche précise sur un projet. (https://pipedream.com/apps/harvest/actions/get-task-assignment)
Vocabulaire français : Obtenir une entrée de temps — Récupère une saisie de temps précise à partir de son identifiant. (https://pipedream.com/apps/harvest/actions/get-time-entry)
Vocabulaire français : Obtenir un rapport de temps — Retourne les heures totales agrégées par clients, projets, tâches ou équipe sur une période donnée. (https://pipedream.com/apps/harvest/actions/get-time-report)
Vocabulaire français : Obtenir un utilisateur — Récupère un utilisateur précis à partir de son identifiant. (https://pipedream.com/apps/harvest/actions/get-user)
Vocabulaire français : Obtenir une affectation utilisateur — Récupère une affectation utilisateur précise sur un projet. (https://pipedream.com/apps/harvest/actions/get-user-assignment)
Vocabulaire français : Lister les identifiants de compte — Liste les comptes Harvest accessibles et renvoie leurs identifiants de compte à réutiliser. (https://pipedream.com/apps/harvest/actions/list-account-id-options)
Vocabulaire français : Lister les clients — Liste les clients du compte pour retrouver leurs identifiants. (https://pipedream.com/apps/harvest/actions/list-clients)
Vocabulaire français : Lister les factures — Liste les factures avec filtres possibles pour retrouver leurs identifiants. (https://pipedream.com/apps/harvest/actions/list-invoices)
Vocabulaire français : Lister les affectations de tâches — Liste les affectations de tâches, soit globalement, soit pour un projet précis. (https://pipedream.com/apps/harvest/actions/list-task-assignments)
Vocabulaire français : Lister les tâches — Liste les tâches du compte pour retrouver leurs identifiants. (https://pipedream.com/apps/harvest/actions/list-tasks)
Vocabulaire français : Lister les entrées de temps — Liste les saisies de temps avec filtres ; peut aussi renvoyer seulement le nombre total d'entrées. (https://pipedream.com/apps/harvest/actions/list-time-entries)
Vocabulaire français : Lister les affectations utilisateur — Liste les affectations des utilisateurs, globalement ou pour un projet précis. (https://pipedream.com/apps/harvest/actions/list-user-assignments)
Vocabulaire français : Lister les utilisateurs — Liste les utilisateurs du compte pour retrouver leurs identifiants. (https://pipedream.com/apps/harvest/actions/list-users)
Vocabulaire français : Redémarrer une entrée de temps — Relance une entrée de temps arrêtée pour la faire repartir. (https://pipedream.com/apps/harvest/actions/start-timer)
Vocabulaire français : Arrêter une entrée de temps — Arrête une entrée de temps en cours. (https://pipedream.com/apps/harvest/actions/stop-timer)
Vocabulaire français : Mettre à jour une facture — Modifie une facture existante à partir de son identifiant. (https://pipedream.com/apps/harvest/actions/update-invoice)
Vocabulaire français : Mettre à jour un projet — Modifie un projet existant à partir de son identifiant. (https://pipedream.com/apps/harvest/actions/update-project)
Vocabulaire français : Mettre à jour une affectation de tâche — Modifie une affectation de tâche sur un projet, par exemple pour changer son caractère facturable. (https://pipedream.com/apps/harvest/actions/update-task-assignment)
Vocabulaire français : Mettre à jour une entrée de temps — Modifie une saisie de temps existante à partir de son identifiant. (https://pipedream.com/apps/harvest/actions/update-time-entry)
Vocabulaire français : Mettre à jour un utilisateur — Modifie un utilisateur existant à partir de son identifiant. (https://pipedream.com/apps/harvest/actions/update-user)
Vocabulaire français : Mettre à jour une affectation utilisateur — Modifie une affectation utilisateur sur un projet, par exemple pour changer un taux horaire. (https://pipedream.com/apps/harvest/actions/update-user-assignment)
Vocabulaire français : Nouvelle facture — Déclenche une notification lorsqu'une nouvelle facture est créée. (https://pipedream.com/apps/harvest/triggers/new-invoice-entry)
Vocabulaire français : Nouvelle entrée de feuille de temps — Déclenche une notification lorsqu'une nouvelle entrée de temps est créée. (https://pipedream.com/apps/harvest/triggers/new-timesheet-entry)
- action : Create Invoice — Create a new free-form invoice for a client. Provide Line Items as a JSON array to itemize the invoice. Example: call with clientId set to InGen Corp's client ID, subject="Consulting Services", lineItems= [{"kind":"Service","description":"Genetics consulting","unit_price":2000,"quantity":1}] . See the documentation. (https://pipedream.com/apps/harvest/actions/create-invoice)
- action : Create Project — Create a new project. Example: call with clientId set to InGen Corp's client ID, projectName="Compound Perimeter Fence Upgrade", isBillable=true, billBy="Project", budgetBy="none". See the documentation. (https://pipedream.com/apps/harvest/actions/create-project)
- action : Create Task Assignment — Assign a task to a project. Use Get Projects to find a project ID and List Tasks to find a task ID. Example: call with projectId set to the Jurassic Park Construction project's ID and taskId set to the Genetics Research task's ID to put that task on the project. See the documentation. (https://pipedream.com/apps/harvest/actions/create-task-assignment)
- action : Create Timesheet Entry — Create a new time entry. Two ways to log time, matching the account's Company setting: on duration-based accounts ( wants_timestamp_timers is false — the common case) set Hours to log a completed entry directly. On timestamp-based accounts ( wants_timestamp_timers is true ) leave Hours blank and use Started Time / Ended Time instead — leave both time fields blank too to start a running timer now, or set both to log a completed entry with explicit start/end times. Passing Started/Ended Time on a duration-based account is silently ignored by Harvest (it starts a running timer instead) — if that happens, switch to Hours . Use Get Projects to find a Project ID, List Tasks to find a Task ID, and List Users to find a User ID. Example (duration-based): call with projectId, taskId, spentDate="2026-09-17", hours=3.5. Example (timestamp-based): the same call with hours omitted and startedTime/endedTime set instead. See the documentation and start/end time variant. (https://pipedream.com/apps/harvest/actions/create-timesheet-entry)
- action : Create User — Create a new user in the Harvest account. Example: call with firstName="Ian", lastName="Malcolm", email="ian.malcolm@example.com" to add a new team member. See the documentation. (https://pipedream.com/apps/harvest/actions/create-user)
- action : Create User Assignment — Assign a user to a project. Use Get Projects to find a project ID, and List Users to find user IDs. Example: call with projectId and userId set to staff that person on the project. See the documentation. (https://pipedream.com/apps/harvest/actions/create-user-assignment)
- action : Delete Invoice — Permanently delete an invoice. Use List Invoices to find a valid ID. Example: call with invoiceId set to a draft invoice's ID to remove it before it's sent. See the documentation. (https://pipedream.com/apps/harvest/actions/delete-invoice)
- action : Delete Project — Permanently delete a project and all time entries and expenses tracked to it (invoices are not deleted). Use Get Projects to find a project ID. Example: call with projectId set to a project's ID to permanently remove it. See the documentation. (https://pipedream.com/apps/harvest/actions/delete-project)
- action : Delete Task Assignment — Delete a task assignment from a project (only possible if it has no time entries). Use List Task Assignments to find IDs. Example: call with projectId and taskAssignmentId to remove that task from the project. See the documentation. (https://pipedream.com/apps/harvest/actions/delete-task-assignment)
- action : Delete Time Entry — Permanently delete a time entry. Use List Time Entries to find a valid ID. Example: call with timeEntryId set to a mistakenly logged entry's ID to remove it. See the documentation. (https://pipedream.com/apps/harvest/actions/delete-time-entry)
- action : Delete User — Permanently delete a user (only possible if they have no time entries or expenses). Use List Users to find a valid ID. Example: call with userId set to a departed team member's ID to remove their Harvest access. See the documentation. (https://pipedream.com/apps/harvest/actions/delete-user)
- action : Delete User Assignment — Delete a user assignment from a project (only possible if it has no time entries or expenses). Use List User Assignments to find IDs. Example: call with projectId and userAssignmentId to unstaff that person from the project. See the documentation. (https://pipedream.com/apps/harvest/actions/delete-user-assignment)
- action : Get Invoice — Retrieve a single invoice by ID. Use List Invoices to find a valid ID. Example: call with invoiceId set to a known invoice's ID to check its amount and payment state. See the documentation. (https://pipedream.com/apps/harvest/actions/get-invoice)
- action : Get Me — Retrieve the currently authenticated user from GET /users/me . Takes no ID input. Example: call with no parameters to answer "who am I logged in as in Harvest?". See the documentation. (https://pipedream.com/apps/harvest/actions/get-me)
- action : Get Project — Retrieve a single project by ID. Example: call with projectId set to a known project's ID to see its client, budget, and billing method. See the documentation. (https://pipedream.com/apps/harvest/actions/get-project)
- action : Get Projects — Retrieve one or more projects. Omit Project IDs to list every project in the account (up to 200) — use this to discover project IDs for other Harvest tools. Provide Project IDs to fetch specific projects instead. Example: call with no Project IDs to find the ID for "Jurassic Park Construction" before creating a task assignment on it. See the documentation. (https://pipedream.com/apps/harvest/actions/get-projects)
- action : Get Task Assignment — Retrieve a single task assignment on a project. Use List Task Assignments to find IDs. Example: call with projectId and taskAssignmentId to check whether that task is billable on the project. See the documentation. (https://pipedream.com/apps/harvest/actions/get-task-assignment)
- action : Get Time Entry — Retrieve a single time entry by ID. Use List Time Entries to find a valid ID. Example: call with timeEntryId set to a known entry's ID to see its hours, project, and task. See the documentation. (https://pipedream.com/apps/harvest/actions/get-time-entry)
- action : Get Time Report — Retrieve total hours logged, aggregated by a chosen dimension (clients, projects, tasks, or team) over a date range, automatically following pagination up to 200 results. Use when the user asks "how many hours were logged/worked on X", "how much time did the team spend on Y", or wants a time report/summary/breakdown — this is the only tool that returns aggregated totals; List Time Entries returns individual raw entries you would have to sum yourself. The Report By value selects which /reports/time/{dimension} endpoint is called. Example: call with reportBy="projects", from="20260901", to="20260930" to see total hours logged per project for the month. See the documentation (https://pipedream.com/apps/harvest/actions/get-time-report)
- action : Get User — Retrieve a single user by ID. Use List Users to find a valid ID. To fetch the authenticated user, use Get Me instead. Example: call with userId set to a known user's ID to see their name, email, and role. See the documentation. (https://pipedream.com/apps/harvest/actions/get-user)
- action : Get User Assignment — Retrieve a single user assignment on a project. Use List User Assignments to find IDs. Example: call with projectId and userAssignmentId to check that person's hourly rate on the project. See the documentation. (https://pipedream.com/apps/harvest/actions/get-user-assignment)
- action : List Account ID Options — List the Harvest accounts (companies) the authenticated user has access to, each with its Account ID. Use this first to find the Account ID required by every other Harvest tool. Example: call with no parameters, then pass the returned id as Account ID on any other Harvest tool call. See the documentation. (https://pipedream.com/apps/harvest/actions/list-account-id-options)
- action : List Clients — List clients in the Harvest account, automatically following pagination up to 200 clients. Use this to discover client IDs for Create Invoice , Create Project , and other tools that accept a Client ID. Example: to find InGen Corp's client ID, call with no filters and look for the client named "InGen Corp" in the results. See the documentation. (https://pipedream.com/apps/harvest/actions/list-clients)
- action : List Invoices — List invoices with optional filters, automatically following pagination up to 200 invoices. Use this to discover invoice IDs for Get Invoice , Update Invoice , or Delete Invoice . Example: call with clientId set to InGen Corp's client ID and state="open" to find their unpaid invoices. See the documentation. (https://pipedream.com/apps/harvest/actions/list-invoices)
- action : List Task Assignments — List task assignments, automatically following pagination up to 200. Omit Project ID to use the global endpoint; provide a Project ID to list assignments for a single project. Example: call with projectId set to the Jurassic Park Construction project's ID to see which tasks are billable on it. See the documentation. (https://pipedream.com/apps/harvest/actions/list-task-assignments)
- action : List Tasks — List tasks in the Harvest account, automatically following pagination up to 200 tasks. Use this to discover task IDs for Create Task Assignment , Create Timesheet Entry , and other tools that accept a Task ID. Example: call with isActive=true to find the ID for the "Fence Maintenance" task before assigning it to a project. See the documentation. (https://pipedream.com/apps/harvest/actions/list-tasks)
- action : List Time Entries — Retrieve a list of time entries from Harvest, with optional filters, automatically following pagination up to 200 entries. Use this to discover time entry IDs for Get Time Entry , Update Time Entry , or Delete Time Entry . For a pure "how many entries are there" question, set countOnly to skip fetching any entries and just return the true total — safe even on a huge, unfiltered result set that would otherwise exceed the response-size limit. Pass notes to filter results to entries whose notes contain that text (client-side, case-insensitive substring) — useful for finding one entry inside a large result set without hitting the output-size limit. Example: call with projectId set to a project's ID and from/to set to a date range to total up hours logged that week. See the documentation. (https://pipedream.com/apps/harvest/actions/list-time-entries)
- action : List User Assignments — List user assignments, automatically following pagination up to 200. Omit Project ID to use the global endpoint; provide a Project ID to list assignments for a single project. Example: call with projectId set to the Isla Sorna Genetics Lab project's ID to see who is staffed on it. See the documentation. (https://pipedream.com/apps/harvest/actions/list-user-assignments)
- action : List Users — List users in the Harvest account, automatically following pagination up to 200 users. Use this to discover user IDs for Create User Assignment , Create Timesheet Entry , and other tools that accept a User ID. Example: call with isActive=true to find Alan Grant's user ID before logging time on his behalf. See the documentation. (https://pipedream.com/apps/harvest/actions/list-users)
- action : Start Time Entry — Restart a stopped time entry so it resumes running. Use List Time Entries with Is Running set to false to find a stopped entry to restart. Example: call with timeEntryId set to a stopped entry's ID to resume tracking time on it. See the documentation. (https://pipedream.com/apps/harvest/actions/start-timer)
- action : Stop Time Entry — Stop a currently running time entry. Use List Time Entries with Is Running set to true to find a running entry to stop. Example: call with timeEntryId set to a currently running entry's ID to stop the clock on it. See the documentation. (https://pipedream.com/apps/harvest/actions/stop-timer)
- action : Update Invoice — Update an existing invoice. Use List Invoices to find a valid ID. Example: call with invoiceId set to a draft invoice's ID and subject set to a new value to revise it before sending. See the documentation. (https://pipedream.com/apps/harvest/actions/update-invoice)
- action : Update Project — Update an existing project. Use Get Projects to find a project ID. Example: call with projectId set to a project's ID and projectName set to a new name to rename it. See the documentation. (https://pipedream.com/apps/harvest/actions/update-project)
- action : Update Task Assignment — Update a task assignment on a project. Use List Task Assignments to find IDs. Example: call with projectId, taskAssignmentId, and billable=false to stop billing that task on the project. See the documentation. (https://pipedream.com/apps/harvest/actions/update-task-assignment)
- action : Update Time Entry — Update an existing time entry. Use List Time Entries to find a valid ID. Example: call with timeEntryId set to a logged entry's ID and hours set to a corrected value to fix a mistaken time entry. See the documentation. (https://pipedream.com/apps/harvest/actions/update-time-entry)
- action : Update User — Update an existing user. Use List Users to find a valid ID. Example: call with userId set to a user's ID and lastName set to a new value to update their name. See the documentation. (https://pipedream.com/apps/harvest/actions/update-user)
- action : Update User Assignment — Update a user assignment on a project. Use List User Assignments to find IDs. Example: call with projectId, userAssignmentId, and hourlyRate="150" to set that person's custom billing rate on the project. See the documentation. (https://pipedream.com/apps/harvest/actions/update-user-assignment)
- trigger : New Invoice Entry — Emit new notifications when a new invoice is created (https://pipedream.com/apps/harvest/triggers/new-invoice-entry)
- trigger : New Timesheet Entry — Emit new notifications when a new timesheet entry is created (https://pipedream.com/apps/harvest/triggers/new-timesheet-entry)