Harvest is a simple tool to help track the time spent by your team on each project and task.
Status: Preview |
Tier: Premium |
Version: 1.0.0 |
Name |
Summary |
List all contacts |
|
Add new contact |
|
List all clients |
|
Add new client |
|
List all users |
|
Add new user |
|
UpdateTimeEntry (string DAY_ENTRY_ID, UpdateTimeEntryParameterBody body) |
Update time entry |
Create time entry |
|
List projects |
|
Delete time entry |
|
AddUserToProject (string project_id, AddUserToProjectParameterBody body) |
Add user to a project |
Get time entry by id |
|
List tasks |
|
Get user info |
Name |
Summary |
When a user is added |
|
When a client is added |
|
When a contact is added |
|
When a project is created |
|
When a time entry is created for the current day |
|
TrigNewTimeEntry (string date, [advanced][Optional]string of_user) |
When a time entry is created for date |
Name |
Summary |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Summary: List all contacts
Description: Retrieves a list of all contacts for the authenticated user.
Syntax:
Harvest.ListAllContacts ()
Returns:
Type:array of (TrigNewContactResponseItem)
Summary: Add new contact
Description: Create a new contact.
Syntax:
Harvest.AddNewContact (AddNewContactParameterBody body)
Parameters:
Name |
Type |
Summary |
Required |
Related Action |
body |
|
|
True |
Returns:
Summary: List all clients
Description: Retrieves a list of all clients for the authenticated account.
Syntax:
Harvest.ListAllClients ()
Returns:
Type:array of (TrigNewClientResponseItem)
Summary: Add new client
Description: Create a new client.
Syntax:
Harvest.AddNewClient (AddNewClientParameterBody body)
Parameters:
Name |
Type |
Summary |
Required |
Related Action |
body |
|
|
True |
Returns:
Summary: List all users
Description: Retrieves a list of all users of the authenticated account.
Syntax:
Harvest.ListAllUsers ()
Returns:
Type:array of (GetUserByID_Response)
Summary: Add new user
Description: Create a new user.
Syntax:
Harvest.CreateUser (CreateUserParameterBody body)
Parameters:
Name |
Type |
Summary |
Required |
Related Action |
body |
|
|
True |
Returns:
Summary: Update time entry
Description: Update an existing time entry.
Syntax:
Harvest.UpdateTimeEntry (string DAY_ENTRY_ID, UpdateTimeEntryParameterBody body)
Parameters:
Name |
Type |
Summary |
Required |
Related Action |
DAY_ENTRY_ID |
string (Time Entry Id) |
The id of the time entry |
True |
|
body |
|
|
True |
Returns:
Summary: Create time entry
Description: Create a new time entry.
Syntax:
Harvest.CreateTimeEntry (CreateTimeEntryParameterBody body)
Parameters:
Name |
Type |
Summary |
Required |
Related Action |
body |
|
|
True |
Returns:
Summary: List projects
Description: Lists all projects for the current user.
Syntax:
Harvest.ListProjects ()
Returns:
Type:array of (TrigNewProjectResponseItem)
Summary: Delete time entry
Description: Delete an existing time entry.
Syntax:
Harvest.DeleteTimeEntry (string DAY_ENTRY_ID)
Parameters:
Name |
Type |
Summary |
Required |
Related Action |
DAY_ENTRY_ID |
string (Time Entry Id) |
The id of the time entry |
True |
Returns:
Summary: Add user to a project
Description: Add an existing user to a project.
Syntax:
Harvest.AddUserToProject (string project_id, AddUserToProjectParameterBody body)
Parameters:
Name |
Type |
Summary |
Required |
Related Action |
project_id |
string (Project Id) |
Project Id |
True |
|
body |
|
|
True |
Returns:
Summary: Get time entry by id
Description: Get an existing time entry by id.
Syntax:
Harvest.GetTimeEntry (string DAY_ENTRY_ID)
Parameters:
Name |
Type |
Summary |
Required |
Related Action |
DAY_ENTRY_ID |
string (Time Entry Id) |
The id of the time entry |
True |
Returns:
Summary: List tasks
Description: Retrieves a list of all tasks.
Syntax:
Harvest.ListTasks ()
Returns:
Type:array of (ListTasksResponseItem)
Summary: Get user info
Description: Retrieve a user's details by user id or email.
Syntax:
Harvest.GetUser (string USERID)
Parameters:
Name |
Type |
Summary |
Required |
Related Action |
USERID |
string (User id or email) |
User id or email |
True |
Returns:
Type:GetUserByID_Response
Summary: When a user is added
Description: Triggers when a new user is added.
Syntax:
Harvest.TrigNewUser ()
Returns:
Type:array of (GetUserByID_Response)
Summary: When a client is added
Description: Triggers when a new client is added.
Syntax:
Harvest.TrigNewClient ()
Returns:
Type:array of (TrigNewClientResponseItem)
Summary: When a contact is added
Description: Triggers when a new contact is added.
Syntax:
Harvest.TrigNewContact ()
Returns:
Type:array of (TrigNewContactResponseItem)
Summary: When a project is created
Description: Triggers when a new project is created.
Syntax:
Harvest.TrigNewProject ()
Returns:
Type:array of (TrigNewProjectResponseItem)
Summary: When a time entry is created for the current day
Description: Triggers when a new time entry is created for the current day.
Syntax:
Harvest.TrigNewTimeEntryToday ([Optional]string of_user)
Parameters:
Name |
Type |
Summary |
Required |
Related Action |
of_user |
string (Other User ID) |
The id of the user to check time entries for. Defaults to your id. |
False |
Returns:
Type:GetTimeEntriesForDay_Response
Summary: When a time entry is created for date
Description: Triggers when a new time entry is created for a specific date.
Syntax:
Harvest.TrigNewTimeEntry (string date, [advanced][Optional]string of_user)
Parameters:
Name |
Type |
Summary |
Required |
Related Action |
date |
string (Date) |
YYYY-MM-DD or ISO format datetime |
True |
|
of_user |
string (Other User ID) |
The id of the user to check time entries for. |
False |
Returns:
Type:GetTimeEntriesForDay_Response
Summary:
Description:
Properties:
Name |
Type |
Summary |
client |
|
|
Summary:
Description:
Properties:
Name |
Type |
Summary |
name |
string Name |
Client's name |
currency |
string Currency |
The currency you'd like to use for the client. |
currency_symbol |
string Currency symbol |
Symbol that correlates to the selected currency. |
details |
string Details |
Additional details, normally used for address information. |
Summary:
Description:
Properties:
Name |
Type |
Summary |
contact |
|
contact |
Summary:
Description: contact
Properties:
Name |
Type |
Summary |
client_id |
integer(int32) Client id |
Unique identifier of the client. |
first_name |
string First name |
Contact's first name. |
last_name |
string Last name |
Contact's last name. |
|
string |
Contact's email. |
phone_office |
string Office phone |
Contact's office phone. |
phone_mobile |
string Mobile phone |
Contact's mobile phone. |
fax |
string Fax |
Contact's fax. |
title |
string Title |
Contact's title. |
Summary:
Description:
Properties:
Name |
Type |
Summary |
user |
|
|
Summary:
Description:
Properties:
Name |
Type |
Summary |
id |
integer(int32) User Id |
User |
Summary:
Description:
Properties:
Name |
Type |
Summary |
notes |
string
|
|
hours |
integer(int32)
|
|
project_id |
string Project Id |
Project |
task_id |
string Task Id |
Task |
spent_at |
string Date |
Spent at |
Summary:
Description:
Properties:
Name |
Type |
Summary |
user |
|
|
Summary:
Description:
Properties:
Name |
Type |
Summary |
|
string |
|
is_admin |
boolean Is admin |
|
first_name |
string First name |
|
last_name |
string Last name |
|
is_contractor |
boolean Is contractor |
|
telephone |
string Phone |
|
has_access_to_all_future_projects |
boolean
|
|
default_hourly_rate |
number(float) Hourly rate |
Default hourly rate. |
department |
string Department |
|
cost_rate |
number(float) Cost rate |
|
Summary:
Description:
Properties:
Name |
Type |
Summary |
day_entries |
array of (Day_entriesItem) day_entries |
day_entries |
for_day |
string for_day |
for_day |
Summary:
Description:
Properties:
Name |
Type |
Summary |
project_id |
string Project id |
Unique identifier of the porject. |
project |
string Project name |
Name of the project. |
user_id |
integer(int32) User id |
Unique identifier of the user. |
spent_at |
string Date |
YYYY-MM-DD |
task_id |
string Task id |
Id of task the time entry is associated with. |
task |
string Task |
Name of task the time entry is associated with. |
client |
string Client |
Name of client the time entry is associated with. |
id |
integer(int32) Time entry id |
Unique identifier of the time entry. |
notes |
string Notes |
Time entry notes. |
started_at |
string Started date-time |
YYYY-MM-DDThh:mm:ssZ (UTC format). |
ended_at |
string Ended date-time |
YYYY-MM-DDThh:mm:ssZ (UTC format). |
created_at |
string(date-time) Created date-time |
YYYY-MM-DDThh:mm:ssZ (UTC format). |
updated_at |
string(date-time) Updated date-time |
YYYY-MM-DDThh:mm:ssZ (UTC format). |
hours_without_timer |
number(float) Hours without timer |
Current amount of time tracked, if timer is not running. |
hours |
number(float) Hours |
Number of (decimal time) hours tracked in this time entry. |
Summary:
Description:
Properties:
Name |
Type |
Summary |
user |
|
|
Summary:
Description:
Properties:
Name |
Type |
Summary |
id |
integer(int32) User id |
Unique identifier of the user. |
|
string |
User's email. |
created_at |
string(date-time) Created date-time |
YYYY-MM-DDThh:mm:ssZ (UTC format). |
is_admin |
boolean Is admin |
True if the user is an admin. |
first_name |
string First name |
User's first name. |
last_name |
string Last name |
User's last name. |
timezone |
string
|
|
is_contractor |
boolean Is contractor |
True if the user is a contractor. |
telephone |
string Phone |
User's phone. |
is_active |
boolean Is active |
True if the user is currently active. |
has_access_to_all_future_projects |
boolean
|
|
default_hourly_rate |
number(float) Hourly rate |
User's hourly rate |
department |
string Department |
Department name the user works in. |
wants_newsletter |
boolean Newsletter subscription |
True if the user wants to subscribe to the newsletter. |
updated_at |
string(date-time) Updated date-time |
YYYY-MM-DDThh:mm:ssZ (UTC format). |
cost_rate |
number(float) Cost rate |
User's cost rate. |
weekly_capacity |
integer(int32) Weekly capacity |
User's weekly capacity. |
Summary:
Description:
Properties:
Name |
Type |
Summary |
task |
|
|
Summary:
Description:
Properties:
Name |
Type |
Summary |
id |
integer(int32) Task id |
Unique identifier of the task. |
name |
string Name |
Task name. |
billable_by_default |
boolean internal |
|
created_at |
string(date-time) Created date-time |
YYYY-MM-DDThh:mm:ssZ (UTC). |
updated_at |
string(date-time) Updated date-time |
YYYY-MM-DDThh:mm:ssZ (UTC). |
is_default |
boolean
|
|
default_hourly_rate |
number(float) Default hourly rate |
Default rate for the task. |
deactivated |
boolean
|
|
Summary:
Description:
Properties:
Name |
Type |
Summary |
client |
|
|
Summary:
Description:
Properties:
Name |
Type |
Summary |
id |
integer(int32) Client id |
Unique identifier of the client. |
name |
string Name |
Client's name. |
active |
boolean
|
|
currency |
string Currency |
Currency to use for client billing. |
cache_version |
integer(int32)
|
|
updated_at |
string(date-time) Updated date-time |
YYYY-MM-DDThh:mm:ssZ (UTC format). |
created_at |
string(date-time) Created date-time |
YYYY-MM-DDThh:mm:ssZ (UTC format). |
statement_key |
string
|
|
default_invoice_kind |
string
|
|
default_invoice_timeframe |
string
|
|
address |
string Address |
Client's address. |
currency_symbol |
string Currency symbol |
Symbol that correlates to the selected currency. |
details |
string Details |
Additional details, normally used for address information. |
last_invoice_kind |
string
|
|
Summary:
Description:
Properties:
Name |
Type |
Summary |
contact |
|
contact |
Summary:
Description: contact
Properties:
Name |
Type |
Summary |
id |
integer(int32) Contact id |
Unique identifier of the contact. |
client_id |
integer(int32) Client id |
Unique identifier of the client. |
first_name |
string First name |
Contact's first name. |
last_name |
string Last name |
Contact's last name. |
|
string |
Contact's email. |
phone_office |
string Office phone |
Contact's office phone. |
phone_mobile |
string Mobile phone |
Contact's mobile phone. |
fax |
string Fax |
Contact's fax. |
title |
string Title |
Contact's title. |
created_at |
string(date-time) Created date-time |
YYYY-MM-DDThh:mm:ssZ (UTC format). |
updated_at |
string(date-time) Updated date-time |
YYYY-MM-DDThh:mm:ssZ (UTC format). |
Summary:
Description:
Properties:
Name |
Type |
Summary |
project |
|
|
Summary:
Description:
Properties:
Name |
Type |
Summary |
id |
integer(int32) Project id |
Unique identifier of the project. |
client_id |
integer(int32) Client id |
Id of client for the project. |
name |
string Name |
Project name. |
code |
string Code |
Project code. |
active |
boolean Is active |
True if the project is currently active. |
billable |
boolean Is billable |
True if the project is billable. |
bill_by |
string Bill by |
Method by which the project is invoiced. |
hourly_rate |
number(float) Hourly rate |
Billing rate by the hour. |
budget |
number(float) Budget |
Budget value for the project. |
budget_by |
string Budget by |
Budgeting method for the project. |
notify_when_over_budget |
boolean
|
|
over_budget_notification_percentage |
number(float)
|
|
over_budget_notified_at |
string
|
|
show_budget_to_all |
boolean
|
|
created_at |
string(date-time) Created date-time |
YYYY-MM-DDThh:mm:ssZ (UTC format). |
updated_at |
string(date-time) Updated date-time |
YYYY-MM-DDThh:mm:ssZ (UTC format). |
starts_on |
string Start date |
YYYY-MM-DD |
ends_on |
string End date |
YYYY-MM-DD |
estimate |
number(float) Estimate |
Project estimate. |
estimate_by |
string Estimated by |
Method of estimation for project. |
hint_earliest_record_at |
string Earliest record date |
YYYY-MM-DD |
hint_latest_record_at |
string Latest record date |
YYYY-MM-DD |
notes |
string Notes |
Project notes. |
cost_budget |
number(float) Cost budget |
Budget value for Total Project Fees projects. |
cost_budget_include_expenses |
boolean Cost budget includes expenses |
Option for budget of Total Project Fees projects to include tracked expenses. |
Summary:
Description:
Properties:
Name |
Type |
Summary |
project_id |
string Project Id |
Project |
task_id |
string Task Id |
Task |
notes |
string Notes |
|
started_at |
string Started date-time |
YYYY-MM-DDThh:mm:ssZ (UTC format). |
ended_at |
string Ended date-time |
YYYY-MM-DDThh:mm:ssZ (UTC format). |
spent_at |
string Date |
YYYY-MM-DDThh:mm:ssZ (UTC format). |
Summary:
Description:
Properties:
Name |
Type |
Summary |
id |
integer(int32) Time entry id |
Unique identifier of the time entry. |
user_id |
integer(int32) User id |
Unique identifier of the user who created the time entry. |
spent_at |
string Date |
Date of time entry. |
created_at |
string(date-time) Created date-time |
YYYY-MM-DDThh:mm:ssZ (UTC format). |
updated_at |
string(date-time) Updated date-time |
YYYY-MM-DDThh:mm:ssZ (UTC format). |
project_id |
string Project id |
Id of the project time entry is associated with. |
task_id |
string Task id |
Id of the task time entry is associated with. |
project |
string Project |
Name of project the time entry is associated with. |
task |
string Task |
Name of task the time entry is associated with. |
client |
string Client |
Name of client the time entry is associated with. |
notes |
string Notes |
Time entry notes. |
hours_without_timer |
number(float) Hours without timer |
Current amount of time tracked, if timer is not running. |
hours |
number(float) Hours |
Number of (decimal time) hours tracked in this time entry. |