Skip to content

Default

Harvest
API integration

Ship Default features without building the integration. Full Harvest API access via Proxy, normalized data through Unified APIs — extend models and mappings to fit your product.

Talk to us
Harvest

Use Cases

Why integrate with Harvest

Common scenarios for SaaS companies building Harvest integrations for their customers.

01

Automate contractor payouts from tracked hours

A payroll or contractor management SaaS can pull approved time entries and user billing rates from their customers' Harvest accounts to automatically calculate and process payouts — eliminating manual timesheet exports.

02

Sync Harvest users into your platform's directory

Any B2B SaaS that needs to map external users to internal accounts can use the Unified User Directory API to pull Harvest users and roles, enabling seamless identity matching and permission management.

03

Provision projects and assignments from deal close

A CRM or professional services automation tool can automatically create Harvest clients, projects, and user assignments when a deal is won, so delivery teams can start tracking time immediately without manual setup.

04

Ingest time and project data for profitability dashboards

BI and analytics SaaS platforms can continuously pull time entries, project budgets, and expense data from Harvest to build real-time margin and utilization reports alongside revenue data from other sources.

05

Enable embedded time tracking from within your product

Project management, ticketing, or developer tools can let their users start and stop Harvest timers directly from their UI, logging time entries with external references that link back to the originating ticket or task.

What You Can Build

Ship these features with Truto + Harvest

Concrete product features your team can ship faster by leveraging Truto’s Harvest integration instead of building from scratch.

01

Harvest user and role sync via Unified User Directory

Pull Harvest users, roles, and capacity data into your platform using Truto's Unified User Directory API to map identities and manage access.

02

Automated timesheet ingestion pipeline

Periodically fetch filtered time entries (by date range, billed status, or user) to feed payroll calculations, invoicing workflows, or project health dashboards.

03

One-click project and client provisioning

Automatically create Harvest clients, projects, and user assignments from events in your product — like closing a deal or kicking off an onboarding workflow.

04

Embedded start/stop timer with external reference linking

Let users log Harvest time entries directly from your UI, passing your entity ID and permalink into Harvest's external_reference field for full traceability.

05

Invoice status sync for client portals

Pull Harvest invoices and payment statuses into your product so end-clients see up-to-date billing information, and push payment confirmations back to keep Harvest in sync.

06

Team utilization and capacity overview

Combine Harvest user capacity data with logged time entries to surface real-time utilization percentages and flag over- or under-allocated team members.

Unified APIs

Unified APIs for Harvest

Skip writing code for every integration. Use Truto’s category-specific Unified APIs out of the box or customize the mappings with AI.

Unified User Directory API

Roles

The Role object represents a role of a User.

View Docs

Users

The User object represents a User.

View Docs

How It Works

From zero to integrated

Go live with Harvest in under an hour. No boilerplate, no maintenance burden.

01

Link your customer’s Harvest account

Use Truto’s frontend SDK to connect your customer’s Harvest account. We handle all OAuth and API key flows — you don’t need to create the OAuth app.

02

We handle authentication

Don’t spend time refreshing access tokens or figuring out secure storage. We handle it and inject credentials into every API request.

03

Call our API, we call Harvest

Truto’s Proxy API is a 1-to-1 mapping of the Harvest API. You call us, we call Harvest, and pass the response back in the same cycle.

04

Unified response format

Every response follows a single format across all integrations. We translate Harvest’s pagination into unified cursor-based pagination. Data is always in the result attribute.

FAQs

Common questions about Harvest on Truto

Authentication, rate limits, data freshness, and everything else you need to know before you integrate.

What authentication method does Harvest use?

Harvest supports OAuth 2.0 for third-party integrations. Truto handles the full OAuth flow, token storage, and automatic refresh so your team doesn't need to manage credentials or deal with token expiry.

Which Unified APIs does Truto support for Harvest today?

Truto currently maps Harvest to the Unified User Directory API, covering Me, Roles, and Users resources. Additional Harvest-specific tools and unified models can be built on request.

Can I access Harvest data beyond users and roles through Truto?

Yes. While the Unified User Directory API is available out of the box, Truto can build custom tools on request to cover Harvest's full API surface — including time entries, projects, clients, invoices, expenses, and user assignments.

Does Harvest impose API rate limits?

Harvest's API enforces a rate limit of 100 requests per 15 seconds per access token. Truto manages request pacing and pagination automatically so your integration stays within these limits without manual throttling.

Can I filter Harvest time entries by date or billing status?

Harvest's API supports filtering time entries by date range (from/to), user, project, client, and billed status (is_billed). Once the time entries tool is enabled, Truto passes these filters through so you can pull exactly the data you need.

How does Harvest distinguish between employees and contractors?

Each Harvest user object includes an is_contractor boolean and a roles attribute. This data is accessible through the Unified User Directory API, making it straightforward to segment users by employment type for payroll or compliance workflows.

Harvest

Get Harvest integrated into your app

Our team understands what it takes to make a Harvest integration successful. A short, crisp 30 minute call with folks who understand the problem.

Talk to us