Read live in your browser

Migration guide

Move your data from Harvest

Your browser reads Harvest directly with a key you create there. The key stays in your browser; Calisto only receives your records, and you can stop and pick up again any day.

What moves

What comes across

  • Clients

    Lands in Calisto as Contacts · 5 fields

    Clients, archived ones inactive

  • Client contacts

    Lands in Calisto as Contacts · 10 fields

    The people at each client

  • Team

    Lands in Calisto as Records · 7 fields

    Matched to your team by email; anyone not on it yet waits until you invite them

  • Projects

    Lands in Calisto as Records · 17 fields

    Projects with their client, code, currency, fee and budget

  • Tasks

    Lands in Calisto as Records · 6 fields

    Each project's tasks, archived ones kept with their time

  • Billable rates

    Lands in Calisto as Records · 9 fields

    What an hour billed, with its history by date

  • Cost rates

    Lands in Calisto as Records · 6 fields

    What each person's hour cost, with its history by date

  • Expense categories

    Lands in Calisto as Records · 8 fields

    Categories; one priced per unit becomes a mileage category

  • Invoices

    Lands in Calisto as Records · 17 fields

    Invoices with their lines

  • Payments

    Lands in Calisto as Records · 6 fields

    Payments received, partial ones included

  • Time

    Lands in Calisto as Records · 17 fields

    Every time entry, billable or not, linked to its invoice

  • Approved weeks

    Lands in Calisto as Records · 5 fields

    Weeks Harvest had approved or locked

  • Expenses

    Lands in Calisto as Records · 20 fields

    Expenses with their receipts and mileage

  • Estimates

    Lands in Calisto as Records · 9 fields

    Estimates, as proposals

  • Archived projects

    Lands in Calisto as Records · 2 fields

    Archived projects are closed once their history is in

Live pull

The key you will need

  • Personal access token

    In Harvest, open id.getharvest.com/developers, choose Create new personal access token, and copy the token.

  • Account ID

    Shown under the token on the same page (id.getharvest.com/developers).

If Harvest ever refuses your browser, the same source switches to its export file below.

Export file

Exporting from Harvest

  1. The quickest way is your own personal access token: in Harvest, open id.getharvest.com/developers, create a token, and enter it with your Account ID above. That reads everything, rate history included.
  2. To move by file instead, export each list below from Harvest as CSV (or Excel), over the whole period you want to bring.
  3. Drop the files together (a ZIP of them works too). Calisto reads them in your browser and shows what it will import, and what it holds back and why, before anything is saved.

Archived clients, projects, tasks and people are included when you choose to show archived items before exporting. A JSON file saved from Harvest's API works too.

Harvest’s own help page

Before your first import you accept the Data Import Terms: you bring your own data with credentials you hold, and Calisto acts as your processor. Calisto never contacts the vendor for you and never sees your key. Read the terms