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_idstringYour Harvest Account ID used for API requests.
access_tokenstringYour 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.