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
- 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.
- To move by file instead, export each list below from Harvest as CSV (or Excel), over the whole period you want to bring.
- 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 pageBefore 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