Harvest

Harvest is a simple tool to help track the time spent by your team on each project and task.

This connector is available in the following products and regions:

Service	Class	Regions
Logic Apps	Standard	All Logic Apps regions except the following:      -   Azure Government regions      -   Azure China regions      -   US Department of Defense (DoD)
Power Automate	Premium	All Power Automate regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)
Power Apps	Premium	All Power Apps regions except the following:      -   US Government (GCC)      -   US Government (GCC High)      -   China Cloud operated by 21Vianet      -   US Department of Defense (DoD)

Contact
Name	Microsoft
URL	Microsoft LogicApps Support Microsoft Power Automate Support Microsoft Power Apps Support

Connector Metadata
Publisher	Microsoft
Website	https://www.getharvest.com/
Privacy policy	https://www.getharvest.com/privacy-policy

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	100	60 seconds
Frequency of trigger polls	1	60 seconds

Actions

Add new client	Create a new client.
Add new contact	Create a new contact.
Add new user	Create a new user.
Add user to a project	Add an existing user to a project.
Create time entry	Create a new time entry.
Delete time entry	Delete an existing time entry.
Get time entry by id	Get an existing time entry by id.
Get user info	Retrieve a user's details by user id or email.
List all clients	Retrieves a list of all clients for the authenticated account.
List all contacts	Retrieves a list of all contacts for the authenticated user.
List projects	Lists all projects for the current user.
List tasks	Retrieves a list of all tasks.
Update time entry	Update an existing time entry.

Add new client

Operation ID:

AddNewClient

Create a new client.

Parameters

Name	Key	Required	Type	Description
Name	name	True	string	Client's name
Currency	currency		string	The currency you'd like to use for the client.
Currency symbol	currency_symbol		string	Symbol that correlates to the selected currency.
Details	details		string	Additional details, normally used for address information.

Add new contact

Operation ID:

AddNewContact

Create a new contact.

Parameters

Name	Key	Required	Type	Description
Client id	client_id	True	integer	Unique identifier of the client.
First name	first_name	True	string	Contact's first name.
Last name	last_name	True	string	Contact's last name.
Email	email		string	Contact's email.
Office phone	phone_office		string	Contact's office phone.
Mobile phone	phone_mobile		string	Contact's mobile phone.
Fax	fax		string	Contact's fax.
Title	title		string	Contact's title.

Add new user

Operation ID:

CreateUser

Create a new user.

Parameters

Name	Key	Required	Type	Description
Email	email	True	string
Is admin	is_admin		boolean
First name	first_name	True	string
Last name	last_name	True	string
Is contractor	is_contractor		boolean
Phone	telephone		string
Hourly rate	default_hourly_rate		float	Default hourly rate.
Department	department		string
Cost rate	cost_rate		float

Add user to a project

Operation ID:

AddUserToProject

Add an existing user to a project.

Parameters

Name	Key	Required	Type	Description
Project Id	project_id	True	string	Project Id
User Id	id	True	integer	User

Create time entry

Operation ID:

CreateTimeEntry

Create a new time entry.

Parameters

Name	Key	Required	Type	Description
notes	notes		string
hours	hours		integer
Project Id	project_id	True	string	Project
Task Id	task_id	True	string	Task
Date	spent_at		string	Spent at

Returns

Body

UpdateTimeEntry_Response

Delete time entry

Operation ID:

DeleteTimeEntry

Delete an existing time entry.

Parameters

Name	Key	Required	Type	Description
Time Entry Id	DAY_ENTRY_ID	True	string	The id of the time entry

Get time entry by id

Operation ID:

GetTimeEntry

Get an existing time entry by id.

Parameters

Name	Key	Required	Type	Description
Time Entry Id	DAY_ENTRY_ID	True	string	The id of the time entry

Returns

Body

UpdateTimeEntry_Response

Get user info

Operation ID:

GetUser

Retrieve a user's details by user id or email.

Parameters

Name	Key	Required	Type	Description
User id or email	USERID	True	string	User id or email

Returns

Body

GetUserByID_Response

List all clients

Operation ID:

ListAllClients

Retrieves a list of all clients for the authenticated account.

Returns

Items

ListAllClients_Response

List all contacts

Operation ID:

ListAllContacts

Retrieves a list of all contacts for the authenticated user.

Returns

Items

ListAllContacts_Response

List projects

Operation ID:

ListProjects

Lists all projects for the current user.

Returns

Items

ListProjects_Response

List tasks

Operation ID:

ListTasks

Retrieves a list of all tasks.

Returns

Items

ListTasks_Response

Update time entry

Operation ID:

UpdateTimeEntry

Update an existing time entry.

Parameters

Name	Key	Required	Type	Description
Time Entry Id	DAY_ENTRY_ID	True	string	The id of the time entry
Project Id	project_id	True	string	Project
Task Id	task_id	True	string	Task
Notes	notes		string
Started date-time	started_at		string	YYYY-MM-DDThh:mm:ssZ (UTC format).
Ended date-time	ended_at		string	YYYY-MM-DDThh:mm:ssZ (UTC format).
Date	spent_at		string	YYYY-MM-DDThh:mm:ssZ (UTC format).

Returns

Body

UpdateTimeEntry_Response

Triggers

When a client is added	Triggers when a new client is added.
When a contact is added	Triggers when a new contact is added.
When a project is created	Triggers when a new project is created.
When a time entry is created for date	Triggers when a new time entry is created for a specific date.
When a time entry is created for the current day	Triggers when a new time entry is created for the current day.
When a user is added	Triggers when a new user is added.

When a client is added

Operation ID:

TrigNewClient

Triggers when a new client is added.

Returns

Name	Path	Type	Description
Client id	client.id	integer	Unique identifier of the client.
Name	client.name	string	Client's name.
Currency	client.currency	string	Currency to use for client billing.
Updated date-time	client.updated_at	date-time	YYYY-MM-DDThh:mm:ssZ (UTC format).
Created date-time	client.created_at	date-time	YYYY-MM-DDThh:mm:ssZ (UTC format).
Address	client.address	string	Client's address.
Currency symbol	client.currency_symbol	string	Symbol that correlates to the selected currency.
Details	client.details	string	Additional details, normally used for address information.

When a contact is added

Operation ID:

TrigNewContact

Triggers when a new contact is added.

Returns

Name	Path	Type	Description
Contact id	contact.id	integer	Unique identifier of the contact.
Client id	contact.client_id	integer	Unique identifier of the client.
First name	contact.first_name	string	Contact's first name.
Last name	contact.last_name	string	Contact's last name.
Email	contact.email	string	Contact's email.
Office phone	contact.phone_office	string	Contact's office phone.
Mobile phone	contact.phone_mobile	string	Contact's mobile phone.
Fax	contact.fax	string	Contact's fax.
Title	contact.title	string	Contact's title.
Created date-time	contact.created_at	date-time	YYYY-MM-DDThh:mm:ssZ (UTC format).
Updated date-time	contact.updated_at	date-time	YYYY-MM-DDThh:mm:ssZ (UTC format).

When a project is created

Operation ID:

TrigNewProject

Triggers when a new project is created.

Returns

Name	Path	Type	Description
Project id	project.id	integer	Unique identifier of the project.
Client id	project.client_id	integer	Id of client for the project.
Name	project.name	string	Project name.
Code	project.code	string	Project code.
Is active	project.active	boolean	True if the project is currently active.
Is billable	project.billable	boolean	True if the project is billable.
Bill by	project.bill_by	string	Method by which the project is invoiced.
Hourly rate	project.hourly_rate	float	Billing rate by the hour.
Budget	project.budget	float	Budget value for the project.
Budget by	project.budget_by	string	Budgeting method for the project.
Created date-time	project.created_at	date-time	YYYY-MM-DDThh:mm:ssZ (UTC format).
Updated date-time	project.updated_at	date-time	YYYY-MM-DDThh:mm:ssZ (UTC format).
Start date	project.starts_on	string	YYYY-MM-DD
End date	project.ends_on	string	YYYY-MM-DD
Estimate	project.estimate	float	Project estimate.
Estimated by	project.estimate_by	string	Method of estimation for project.
Earliest record date	project.hint_earliest_record_at	string	YYYY-MM-DD
Latest record date	project.hint_latest_record_at	string	YYYY-MM-DD
Notes	project.notes	string	Project notes.
Cost budget	project.cost_budget	float	Budget value for Total Project Fees projects.
Cost budget includes expenses	project.cost_budget_include_expenses	boolean	Option for budget of Total Project Fees projects to include tracked expenses.

When a time entry is created for date

Operation ID:

TrigNewTimeEntry

Triggers when a new time entry is created for a specific date.

Parameters

Name	Key	Required	Type	Description
Date	date	True	string	YYYY-MM-DD or ISO format datetime
Other User ID	of_user		string	The id of the user to check time entries for.

Returns

Body

GetTimeEntriesForDay_Response

When a time entry is created for the current day

Operation ID:

TrigNewTimeEntryToday

Triggers when a new time entry is created for the current day.

Parameters

Name	Key	Required	Type	Description
Other User ID	of_user		string	The id of the user to check time entries for. Defaults to your id.

Returns

Body

GetTimeEntriesForDay_Response

When a user is added

Operation ID:

TrigNewUser

Triggers when a new user is added.

Returns

Body

GetUserByID_Response

Definitions

ListAllContacts_Response

Name	Path	Type	Description
Contact id	contact.id	integer	Unique identifier of the contact.
Client id	contact.client_id	integer	Unique identifier of the client.
First name	contact.first_name	string	Contact's first name.
Last name	contact.last_name	string	Contact's last name.
Email	contact.email	string	Contact's email.
Office phone	contact.phone_office	string	Contact's office phone.
Mobile phone	contact.phone_mobile	string	Contact's mobile phone.
Fax	contact.fax	string	Contact's fax.
Title	contact.title	string	Contact's title.
Created date-time	contact.created_at	date-time	YYYY-MM-DDThh:mm:ssZ (UTC format).
Updated date-time	contact.updated_at	date-time	YYYY-MM-DDThh:mm:ssZ (UTC format).

ListAllClients_Response

Name	Path	Type	Description
Client id	client.id	integer	Unique identifier of the client.
Name	client.name	string	Client's name.
Currency	client.currency	string	Currency to use for client billing.
Updated date-time	client.updated_at	date-time	YYYY-MM-DDThh:mm:ssZ (UTC format).
Created date-time	client.created_at	date-time	YYYY-MM-DDThh:mm:ssZ (UTC format).
Address	client.address	string	Client's address.
Currency symbol	client.currency_symbol	string	Symbol that correlates to the selected currency.
Details	client.details	string	Additional details, normally used for address information.

UpdateTimeEntry_Response

Name	Path	Type	Description
Time entry id	id	integer	Unique identifier of the time entry.
User id	user_id	integer	Unique identifier of the user who created the time entry.
Date	spent_at	string	Date of time entry.
Created date-time	created_at	date-time	YYYY-MM-DDThh:mm:ssZ (UTC format).
Updated date-time	updated_at	date-time	YYYY-MM-DDThh:mm:ssZ (UTC format).
Project id	project_id	string	Id of the project time entry is associated with.
Task id	task_id	string	Id of the task time entry is associated with.
Project	project	string	Name of project the time entry is associated with.
Task	task	string	Name of task the time entry is associated with.
Client	client	string	Name of client the time entry is associated with.
Notes	notes	string	Time entry notes.
Hours without timer	hours_without_timer	float	Current amount of time tracked, if timer is not running.
Hours	hours	float	Number of (decimal time) hours tracked in this time entry.

ListProjects_Response

Name	Path	Type	Description
Project id	project.id	integer	Unique identifier of the project.
Client id	project.client_id	integer	Id of client for the project.
Name	project.name	string	Project name.
Code	project.code	string	Project code.
Is active	project.active	boolean	True if the project is currently active.
Is billable	project.billable	boolean	True if the project is billable.
Bill by	project.bill_by	string	Method by which the project is invoiced.
Hourly rate	project.hourly_rate	float	Billing rate by the hour.
Budget	project.budget	float	Budget value for the project.
Budget by	project.budget_by	string	Budgeting method for the project.
Created date-time	project.created_at	date-time	YYYY-MM-DDThh:mm:ssZ (UTC format).
Updated date-time	project.updated_at	date-time	YYYY-MM-DDThh:mm:ssZ (UTC format).
Start date	project.starts_on	string	YYYY-MM-DD
End date	project.ends_on	string	YYYY-MM-DD
Estimate	project.estimate	float	Project estimate.
Estimated by	project.estimate_by	string	Method of estimation for project.
Earliest record date	project.hint_earliest_record_at	string	YYYY-MM-DD
Latest record date	project.hint_latest_record_at	string	YYYY-MM-DD
Notes	project.notes	string	Project notes.
Cost budget	project.cost_budget	float	Budget value for Total Project Fees projects.
Cost budget includes expenses	project.cost_budget_include_expenses	boolean	Option for budget of Total Project Fees projects to include tracked expenses.

ListTasks_Response

Name	Path	Type	Description
Task id	task.id	integer	Unique identifier of the task.
Name	task.name	string	Task name.
internal	task.billable_by_default	boolean
Created date-time	task.created_at	date-time	YYYY-MM-DDThh:mm:ssZ (UTC).
Updated date-time	task.updated_at	date-time	YYYY-MM-DDThh:mm:ssZ (UTC).
Default hourly rate	task.default_hourly_rate	float	Default rate for the task.

GetUserByID_Response

Name	Path	Type	Description
User id	user.id	integer	Unique identifier of the user.
Email	user.email	string	User's email.
Created date-time	user.created_at	date-time	YYYY-MM-DDThh:mm:ssZ (UTC format).
Is admin	user.is_admin	boolean	True if the user is an admin.
First name	user.first_name	string	User's first name.
Last name	user.last_name	string	User's last name.
Is contractor	user.is_contractor	boolean	True if the user is a contractor.
Phone	user.telephone	string	User's phone.
Is active	user.is_active	boolean	True if the user is currently active.
Hourly rate	user.default_hourly_rate	float	User's hourly rate
Department	user.department	string	Department name the user works in.
Newsletter subscription	user.wants_newsletter	boolean	True if the user wants to subscribe to the newsletter.
Cost rate	user.cost_rate	float	User's cost rate.
Weekly capacity	user.weekly_capacity	integer	User's weekly capacity.

GetTimeEntriesForDay_Response

Name	Path	Type	Description
day_entries	day_entries	array of object	day_entries
Project id	day_entries.project_id	string	Unique identifier of the porject.
Project name	day_entries.project	string	Name of the project.
User id	day_entries.user_id	integer	Unique identifier of the user.
Date	day_entries.spent_at	string	YYYY-MM-DD
Task id	day_entries.task_id	string	Id of task the time entry is associated with.
Task	day_entries.task	string	Name of task the time entry is associated with.
Client	day_entries.client	string	Name of client the time entry is associated with.
Time entry id	day_entries.id	integer	Unique identifier of the time entry.
Notes	day_entries.notes	string	Time entry notes.
Started date-time	day_entries.started_at	string	YYYY-MM-DDThh:mm:ssZ (UTC format).
Ended date-time	day_entries.ended_at	string	YYYY-MM-DDThh:mm:ssZ (UTC format).
Created date-time	day_entries.created_at	date-time	YYYY-MM-DDThh:mm:ssZ (UTC format).
Updated date-time	day_entries.updated_at	date-time	YYYY-MM-DDThh:mm:ssZ (UTC format).
Hours without timer	day_entries.hours_without_timer	float	Current amount of time tracked, if timer is not running.
Hours	day_entries.hours	float	Number of (decimal time) hours tracked in this time entry.