Skip to main content

Harvest

Overview​

The Harvest source connector lets you connect to the Harvest API using a personal access token.

Setup​

Prerequisites​

  • A Harvest account
  • An Account ID for the Harvest account you want to connect
  • A Personal Access Token with access to the resources you intend to sync

Create a Harvest personal access token​

  1. In Harvest, go to Settings (or your profile settings).
  2. Find Developers / API / Personal Access Tokens.
  3. Create a new token and copy it somewhere safe.

Find your Harvest Account ID​

Harvest API requests require the Harvest-Account-Id header. You can typically find the Account ID in Harvest account settings or in API documentation/examples for your account.

Authentication​

This connector authenticates with:

  • Access token: sent as a Bearer token (Authorization: Bearer <token>)
  • Account ID: sent as Harvest-Account-Id: <account_id>

The connector validates credentials by calling:

  • GET https://api.harvestapp.com/v2/users/me

Configuration​

FieldTypeRequiredDescription
account_idstring✅Your Harvest Account ID used for API requests.
access_tokenstring✅Your Harvest personal access token.

Streams​

This connector is currently under development.

  • Catalog discovery currently returns an empty catalog.
  • Extraction is not yet available.

If you attempt to run a sync, the connector will fail with a message indicating extraction is still in development.