Harvest (Preview)

Harvest (Preview)

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
Flow Premium All Flow regions except the following:
     -   US Government (GCC)
PowerApps Premium All PowerApps regions except the following:
     -   US Government (GCC)

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.

Required Parameters

Name
string
Client's name

Optional Parameters

Currency
string
The currency you'd like to use for the client.
Currency symbol
string
Symbol that correlates to the selected currency.
Details
string
Additional details, normally used for address information.

Add new contact

Create a new contact.

Required Parameters

Client id
integer
Unique identifier of the client.
First name
string
Contact's first name.
Last name
string
Contact's last name.

Optional Parameters

Email
string
Contact's email.
Office phone
string
Contact's office phone.
Mobile phone
string
Contact's mobile phone.
Fax
string
Contact's fax.
Title
string
Contact's title.

Add new user

Create a new user.

Required Parameters

Email
string
First name
string
Last name
string

Optional Parameters

Is admin
boolean
Is contractor
boolean
Phone
string
Hourly rate
float
Default hourly rate.
Department
string
Cost rate
float

Add user to a project

Add an existing user to a project.

Required Parameters

Project Id
string
Project Id
User Id
integer
User

Create time entry

Create a new time entry.

Required Parameters

Project Id
string
Project
Task Id
string
Task

Optional Parameters

notes
string
hours
integer
Date
string
Spent at

Returns

Delete time entry

Delete an existing time entry.

Required Parameters

Time Entry Id
string
The id of the time entry

Get time entry by id

Get an existing time entry by id.

Required Parameters

Time Entry Id
string
The id of the time entry

Returns

Get user info

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

Required Parameters

User id or email
string
User id or email

Returns

List all clients

Retrieves a list of all clients for the authenticated account.

Required Parameters

Name
string
Client's name

Optional Parameters

Currency
string
The currency you'd like to use for the client.
Currency symbol
string
Symbol that correlates to the selected currency.
Details
string
Additional details, normally used for address information.

Returns

List all contacts

Retrieves a list of all contacts for the authenticated user.

Required Parameters

Name
string
Client's name

Optional Parameters

Currency
string
The currency you'd like to use for the client.
Currency symbol
string
Symbol that correlates to the selected currency.
Details
string
Additional details, normally used for address information.

Returns

List projects

Lists all projects for the current user.

Required Parameters

Name
string
Client's name

Optional Parameters

Currency
string
The currency you'd like to use for the client.
Currency symbol
string
Symbol that correlates to the selected currency.
Details
string
Additional details, normally used for address information.

Returns

List tasks

Retrieves a list of all tasks.

Required Parameters

Name
string
Client's name

Optional Parameters

Currency
string
The currency you'd like to use for the client.
Currency symbol
string
Symbol that correlates to the selected currency.
Details
string
Additional details, normally used for address information.

Returns

Update time entry

Update an existing time entry.

Required Parameters

Time Entry Id
string
The id of the time entry
Project Id
string
Project
Task Id
string
Task

Optional Parameters

Notes
string
Started date-time
string
YYYY-MM-DDThh:mm:ssZ (UTC format).
Ended date-time
string
YYYY-MM-DDThh:mm:ssZ (UTC format).
Date
string
YYYY-MM-DDThh:mm:ssZ (UTC format).

Returns

Triggers

When a client is added

Triggers when a new client is added.

Returns

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

When a contact is added

Triggers when a new contact is added.

Returns

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

When a project is created

Triggers when a new project is created.

Returns

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

When a time entry is created for date

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

Required Parameters

Date
string
YYYY-MM-DD or ISO format datetime

Optional Parameters

Other User ID
string
The id of the user to check time entries for.

Returns

When a time entry is created for the current day

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

Optional Parameters

Other User ID
string
The id of the user to check time entries for. Defaults to your id.

Returns

When a user is added

Triggers when a new user is added.

Returns

Definitions

ListAllContacts_Response

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

ListAllClients_Response

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

UpdateTimeEntry_Response

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

ListProjects_Response

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

ListTasks_Response

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

GetUserByID_Response

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

GetTimeEntriesForDay_Response

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