TimeCamp

Getting Started with TimeCamp

The TimeCamp modules allow you to watch, create, update, list, and delete the projects, tasks, and time entries in your TimeCamp account.

Prerequisites

  • A TimeCamp account

In order to use TimeCamp with Make, it is necessary to have a TimeCamp account. If you do not have one, you can user your Google account or create a TimeCamp account at timecamp.com/register.

Connecting TimeCamp to Make

To connect your TimeCamp account to Make you need to obtain the API Key from your TimeCamp account and insert it in the Create a connection dialog in the Make module.

1. Log in to your TimeCamp account and open your Dashboard.

2. Click you Profile Icon > Your Email Address and scroll down to locate Your Programming API Token.

61f27cd598bcb.gif

3. Copy the API token to your clipboard.

61f27cdba6a1d.png

4. Go to Make and open the TimeCamp module's Create a connection dialog.

61f27cdcf0ff7.gif

5. In the Connection name field, enter a name for the connection.

6. In the API Key field, enter the API key copied in step 4 and click Continue.

The connection has been established.

Creates a new project.

Connection

Establish a connection to your TimeCamp account.

Project Name

Enter a name for the project.

Tags

Enter the keywords that can be used to filter the projects when searching.

External Task ID

Enter the External Task ID related to this project.

External Parent ID

Enter the External Parent ID if this project is part of any other major project.

Budgeted

Enter the number of hours allocated for this project.

Note

Enter the details or any additional information for the project.

Archived

Select whether this project is archived:

  • Yes

  • No

  • Not defined

User IDs

Add the comma-separated User IDs to whom the task is assigned.

Role

Select the role of the user.

Deletes an existing project.

Connection

Establish a connection to your TimeCamp account.

Project ID

Select the Project ID you want to delete.

Updates an existing task.

Connection

Establish a connection to your TimeCamp account.

Task ID

Select the Task ID whose project you want to update.

Project Name

Enter a name for the project.

Tags

Enter the keywords that can be used to filter the projects when searching.

External Task ID

Enter the External Task ID related to this project.

External Parent ID

Enter the External Parent ID if this project is part of any other major project.

Budgeted

Enter the number of hours allocated for this project.

Note

Enter the details or any additional information for the project.

Archived

Select whether this project is archived:

  • Yes

  • No

  • Not defined

Billable

Select whether this project is billable:

  • Yes

  • No

  • Not defined

Budget Unit

Enter the amount billable per hour.

User IDs

Add the comma-separated User IDs to whom the task is assigned.

Role

Select the role of the user.

Triggers when a new project is created.

Connection

Establish a connection to your TimeCamp account.

Limit

Enter the maximum number of projects Make should return during one scenario execution cycle.

Gets a project's information.

Connection

Establish a connection to your TimeCamp account.

Project ID

Select the Project ID whose details you want to retrieve.

Note

If the account has no projects to return, you will receive an error, [403] "You do not have permissions to get the task details".

List all projects.

Connection

Establish a connection to your TimeCamp account.

Run archived tasks only

Select whether you want to list only the archived task projects:

  • Yes

  • No

  • Not defined

Limit

Enter the maximum number of projects Make should return during one scenario execution cycle.

Creates a new task.

Connection

Establish a connection to your TimeCamp account.

Task Name

Enter a name for the task.

Project ID

Select the Project ID for which the task is being created for.

Tags

Enter the keywords that can be used to filter the task when searching.

External Task ID

Enter the External Task ID related to this task.

External Parent ID

Enter the External Parent ID if this task is part of any other major project.

Budgeted

Enter the number of hours allocated for this task.

Note

Enter the details or any additional information for the task.

Archived

Select whether this task is archived:

  • Yes

  • No

  • Not defined

Billable

Select whether this task is billable:

  • Yes

  • No

  • Not defined

Budget Unit

Enter the amount billable per hour.

User IDs

Add the comma-separated User IDs to whom the task is assigned.

Role

Select the role of the user.

Updates an existing task.

Connection

Establish a connection to your TimeCamp account.

Task ID

Select the Task ID you want to update.

Project ID

Select the Project ID associated with the task.

Task Name

Enter a new name for the task.

Tags

Enter the keywords that can be used to filter the task when searching.

External Task ID

Enter the External Task ID related to this task.

External Parent ID

Enter the External Parent ID if this task is part of any other major project.

Budgeted

Enter the number of hours allocated for this task.

Note

Enter the details or any additional information for the task.

Archived

Select whether this task is archived:

  • Yes

  • No

  • Not defined

Billable

Select whether this task is billable:

  • Yes

  • No

  • Not defined

Budget Unit

Enter the amount billable per hour.

User IDs

Add the comma-separated User IDs to whom the task is assigned.

Role

Select the role of the user.

Note

If there is no Task ID exists to update the details, you will receive an error message, [404] null response.

Lists all tasks.

Connection

Establish a connection to your TimeCamp account.

Run archived tasks only

Select whether you want to list only the archived tasks:

  • Yes

  • No

  • Not defined

Limit

Enter the maximum number of tasks Make should return during one scenario execution cycle.

Deletes an existing task.

Connection

Establish a connection to your TimeCamp account.

Task ID

Select the Task ID you want to delete.

Triggers when a new task is created.

Connection

Establish a connection to your TimeCamp account.

Limit

Enter the maximum number of tasks Make should return during one scenario execution cycle.

Gets the task's information.

Connection

Establish a connection to your TimeCamp account.

Task ID

Select the Task ID whose details you want to retrieve.

Gets time entry information.

Connection

Establish a connection to your TimeCamp account.

From Date

Enter the date to list the time entries created or updated on or after the specified date.

To Date

Enter the date to list the time entries created or updated on or before the specified date.

Task IDs

Enter the comma-separated Task IDs whose time entries you want to lis

Limit

Enter the maximum number of time entries Make should return during one scenario execution cycle.

Updates an existing time entry.

Connection

Establish a connection to your TimeCamp account.

Date

Enter the date for which you are creating the time entry.

Duration

Enter the duration of the time entry in seconds.

Note

Enter any additional information about the time entry.

Billable

Select whether the time entry is billable:

  • Yes

  • No

  • Not defined

Start Time

Enter the start time of the time entry in HH:MM format.

End Time

Enter the end time of the time entry in HH:MM format.

Task ID

Select the Task ID associated with the time entry.

Invoice ID

Enter the Invoice ID associated with the time entry.

Update Activities

Select whether you want to update the activities:

  • Yes

  • No

  • Not defined

Creates a new time entry.

Connection

Establish a connection to your TimeCamp account.

Time Entry ID

Enter the Time Entry ID you want to update. You can get the Time Entry IDs using the List Time Entries module.

Duration

Enter the duration of the time entry in seconds.

Note

Enter any additional information for updating the time entry.

Billable

Select whether the time entry is billable:

  • Yes

  • No

  • Not defined

Start Time

Enter the start time of the time entry in HH:MM format.

End Time

Enter the end time of the time entry in HH:MM format.

Task ID

Select the Task ID associated with the time entry.

Performs an arbitrary authorized API call.

Connection

Establish a connection to your TimeCamp account.

URL

Enter a path relative to https://timecamp.com/thrid_party/api. For example: /tasks

For the list of available endpoints, refer to the TimeCamp API Documentation.

Method

Select the HTTP method you want to use:

GETt o retrieve information for an entry.

POST to create a new entry.

PUT to update/replace an existing entry.

PATCH to make a partial entry update.

DELETE to delete an entry.

Headers

Enter the desired request headers. You don't have to add authorization headers; we already did that for you.

Query String

Enter the request query string.

Body

Enter the body content for your API call.

The following API call returns all the tasks from your TimeCamp account:

URL:/tasks

Method:GET

61f27cdf5c518.png

Matches of the search can be found in the module's Output under Bundle > Body > xml > item. In our example, 3 tasks were returned:

61f27ce088f71.png