Advanced Analytica Advanced Analytica: IBOM
← All connectors
Harvest logo

Source connector

Harvest

Set up Harvest as a source and move its data into your chosen destination.

Version 1.2.59 certified generally available

Harvest

Set up the Harvest source connector and review its reference information.

Prerequisites

  • A Harvest account.
  • Your Harvest Account ID. You can find it in the Developers section of Harvest ID, alongside your Personal Access Tokens.
  • One of these authentication methods:
    • OAuth (recommended for Airbyte Cloud). Airbyte Cloud completes the Harvest OAuth flow, so you don’t need a developer application or tokens upfront. Authorise the connection from the source setup page.
    • Personal Access Token (recommended for Airbyte Open Source). Create a Personal Access Token from the Developers section of Harvest ID. The token has the all scope and grants access to every Harvest account on your user.

Set up the connector

For Airbyte Cloud:

  1. Log into your Airbyte Cloud.
  2. Click Sources, then click + New source.
  3. On the Set up the source page, select Harvest from the Source type dropdown.
  4. Enter a name for the Harvest connector.
  5. For Authentication mechanism, select Authenticate via Harvest (OAuth) from the dropdown. Then click Authenticate your Harvest account and authorise the requested account.
  6. Enter your Harvest Account ID.
  7. For Start Date, enter a UTC date and time in YYYY-MM-DDTHH:mm:ssZ format. The connector replicates data created or updated from this date onwards.
  8. Click Set up source.

For Airbyte Open Source:

  1. Go to the Airbyte Open Source dashboard.
  2. Click Sources, then click + New source.
  3. On the Set up the source page, select Harvest from the Source type dropdown.
  4. Enter a name for the Harvest connector.
  5. For Authentication mechanism, select Authenticate with Personal Access Token and paste your Personal Access Token.
  6. Enter your Harvest Account ID.
  7. For Start Date, enter a UTC date and time in YYYY-MM-DDTHH:mm:ssZ format. The connector replicates data created or updated from this date onwards.
  8. Click Set up source.

Supported sync modes

You can use these sync modes with the Harvest source connector:

Supported streams

Performance

Harvest rate limits restricts the connector. Harvest enforces two separate rate limits:

  • General API requests: 100 requests per 15 seconds
  • Reports API requests: 100 requests per 15 minutes

The connector automatically follows these limits through a built-in HTTP API budget. It retries throttled requests using the API’s Retry-After header.

Use the Number of Concurrent Threads field to set the number of concurrent threads. Higher values can speed up syncs but use more of your API rate limit. The default is 4 threads, and you can set between 2 and 10. Choose a lower value when other applications share your Harvest API quota.

Report streams retrieve data in 365-day date windows. These include Expense Reports, Time Reports, Uninvoiced Report, and Project Budget Report. Initial syncs for these streams may take longer when an account has a long history.

Troubleshooting and limits

The connector follows Harvest’s granular permission model. If your credentials can’t access a resource, its stream returns zero records without failing the sync. If a stream returns no data, check that the Harvest user behind the credentials has the required resource permissions.

With OAuth, the granted scopes determine which Harvest accounts the connection can reach. Personal Access Tokens always have the all scope and can reach every Harvest account on your user. OAuth applications may reach only one account, depending on how you registered the application.

IP allow list

If you use Airbyte Cloud and restrict your organisation’s access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.

Changelog

Expand to review
VersionDatePull RequestSubject
1.2.592026-11-1091595Update dependencies
1.2.582026-11-0390593Update dependencies
1.2.572026-10-2789929Update dependencies
1.2.562026-10-2089259Update dependencies
1.2.552026-10-1388646Update dependencies
1.2.542026-10-0687891Update dependencies
1.2.532026-09-2987202Update dependencies
1.2.522026-09-2286690Update dependencies
1.2.512026-09-1586095Update dependencies
1.2.502026-09-0885543Update dependencies
1.2.492026-08-1884608Update dependencies
1.2.482026-08-1183984Update dependencies
1.2.472026-08-0483495Update dependencies
1.2.462026-07-2882948Update dependencies
1.2.452026-07-2182454Update dependencies
1.2.442026-07-1481874Update dependencies
1.2.432026-06-3081106Update dependencies
1.2.422026-06-2380488Update dependencies
1.2.412026-06-1679882Update dependencies
1.2.402026-06-0979365Update dependencies
1.2.392026-06-0278755Update dependencies
1.2.382026-05-0677821Set Content-Type: application/x-www-form-urlencoded on OAuth access token request
1.2.372026-05-0577778Reorder spec fields so credentials appears before account_id and replication_start_date
1.2.362026-05-0476217Declare OAuth2 flow inline via advanced_auth and oauthConnectorInputSpecification
1.2.352026-04-2875371Update dependencies
1.2.342026-04-2176845Bump SDM base image to stable 7.17.2
1.2.332026-04-1376276Rename “concurrent workers” to “concurrent threads” in connector spec
1.2.322026-04-1076247Promoted release candidate to GA
1.2.32-rc.42026-04-0875543Added configurable concurrency level with num_workers parameter and HTTP API budget rate limiting
1.2.32-rc.12026-03-2475409Test dev image of source-declarative-manifest (7.13.0.post6.dev23497311155)
1.2.312026-03-1074687Update dependencies
1.2.302026-02-2473930Update dependencies
1.2.292026-02-1073113Update dependencies
1.2.282026-02-0372645Update dependencies
1.2.272026-01-2071880Update dependencies
1.2.262026-01-1471693Update dependencies
1.2.252025-12-1870496Update dependencies
1.2.242025-11-2570061Update dependencies
1.2.232025-11-1869372Update dependencies
1.2.222025-10-2968814Update dependencies
1.2.212025-10-2268591Add suggestedStreams
1.2.202025-10-2161157Update dependencies
1.2.192025-10-1466013Update to CDK v7
1.2.182025-05-2460670Update dependencies
1.2.172025-05-1059910Update dependencies
1.2.162025-05-0559215Fix missing schema for time_team, users, time_entries, company, & project_assignments streams.
1.2.152025-05-0359254Update dependencies
1.2.142025-04-2658767Update dependencies
1.2.132025-04-1958170Update dependencies
1.2.122025-04-1257717Update dependencies
1.2.112025-04-0557034Update dependencies
1.2.102025-03-2956653Update dependencies
1.2.92025-03-2256066Update dependencies
1.2.82025-03-0855483Update dependencies
1.2.72025-03-0154796Update dependencies
1.2.62025-02-2254327Update dependencies
1.2.52025-02-1553860Update dependencies
1.2.42025-02-0853282Update dependencies
1.2.32025-02-0152747Update dependencies
1.2.22025-01-2552254Update dependencies
1.2.12025-01-2452139Fix low-code state migration
1.2.02025-01-2352109Make incremental per-partition streams concurrent
1.1.92025-01-1851792Update dependencies
1.1.82025-01-1151155Update dependencies
1.1.72025-01-0450629Update dependencies
1.1.62024-12-2150081Update dependencies
1.1.52024-12-1449634Update dependencies
1.1.42024-12-1249213Update dependencies
1.1.32024-12-1148159Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64
1.1.22024-10-2947817Update dependencies
1.1.12024-10-2847670Update dependencies
1.1.02024-10-1446898Promoting release candidate 1.1.0-rc1 to a main version.
1.1.0-rc12024-10-0946685Migrate to Manifest-only
1.0.192024-10-0546470Update dependencies
1.0.182024-09-2846143Update dependencies
1.0.172024-09-2145835Update dependencies
1.0.162024-09-1445537Update dependencies
1.0.152024-09-0744986Update dependencies
1.0.142024-08-2444681Update dependencies
1.0.132024-08-1744263Update dependencies
1.0.122024-08-1043463Update dependencies
1.0.112024-08-0343123Update dependencies
1.0.102024-07-2742831Update dependencies
1.0.92024-07-2042326Update dependencies
1.0.82024-07-1341841Update dependencies
1.0.72024-07-1041381Update dependencies
1.0.62024-07-0941303Update dependencies
1.0.52024-07-0641002Update dependencies
1.0.42024-06-2540475Update dependencies
1.0.32024-06-2240169Update dependencies
1.0.22024-05-0838055Fix error handler for retriable errors
1.0.12024-04-2436641Schema descriptions and CDK 0.80.0
1.0.02024-04-1535863Migrates connector to Low Code CDK, Updates incremental substream state to per-partition state
0.2.02024-04-0836889Unpin CDK version
0.1.242024-02-2635541Improve check command to avoid missing alerts
0.1.232024-02-1935305Fix pendulum parsing error
0.1.222024-02-1235154Manage dependencies with Poetry.
0.1.212023-11-3033003Update expected records
0.1.202023-10-1931599Base image migration: remove Dockerfile and use the python-connector-base image
0.1.192023-07-2628755Changed parameters for Time Reports to use 365 days as opposed to 1 year
0.1.182023-05-2926714Remove authSpecification from spec in favour of advancedAuth
0.1.172023-03-0322983Specified date formatting in specification
0.1.162023-02-0722417Turn on default HttpAvailabilityStrategy
0.1.152023-01-2722008Set AvailabilityStrategy for streams explicitly to None
0.1.142023-01-0921151Skip 403 FORBIDDEN for all stream
0.1.132022-12-2220810Skip 403 FORBIDDEN for EstimateItemCategories stream
0.1.122022-12-1620572Introduce replication end date
0.1.112022-09-2817326Migrate to per-stream states.
0.1.102022-08-0815221Added parent_id for all streams which have parent stream
0.1.92022-08-0415312Fix started_time and ended_time format schema error and updated report slicing
0.1.82021-12-148429Update titles and descriptions
0.1.62021-11-147952Implement OAuth 2.0 support
0.1.52021-09-285747Update schema date-time fields
0.1.42021-06-225071Harvest normalization failure: fixing the schemas
0.1.32021-06-224274Fix wrong data type on statement_key in clients stream
0.1.22021-06-074222Correct specification parameter name
0.1.12021-06-093973Add AIRBYTE_ENTRYPOINT for Kubernetes support
0.1.02021-06-073709Release Harvest connector!
Advanced Analytica

Most businesses are sitting on information they can’t use at speed. The people who hold it are busy, and when they leave, the knowledge goes with them. The documents are static, and the processes around them weren’t designed for AI.

Advanced Analytica works with these businesses to turn that information into structured data assets. Once they're integrated, AI systems can govern it, and the business can use it. We bring in the strategy, the specification and the AI skills to rework how the business operates.

MOVE FAST. STAY SAFE.