Integromat
  • Back to website
Articles in this section
  • Airtable
  • Bubble
  • Email (legacy)
  • Facebook Groups
  • Formstack
  • Google Cloud Vision
  • Google Sheets (legacy)
  • HTTP
  • JSON
  • Magento 2
See more
  1. Integromat Support
  2. Apps
  3. Docs

TimeCamp

Integromat Integromat Updated July 22, 2020 08:24

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 Integromat, 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.

The module dialog fields that are displayed in bold (in the Integromat scenario, not in this documentation article) are mandatory!

Connecting TimeCamp to Integromat

To connect your TimeCamp account to Integromat you need to obtain the API Key from your TimeCamp account and insert it in the Create a connection dialog in the Integromat 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.

SuCfT8wJTt.gif

3. Copy the API token to your clipboard.

UsfpiVmWjY.png

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

HKVFfWIo4B.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.

Other

Make an API Call

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:

GET
to 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.

Example of Use - List Tasks

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

URL:
/tasks

Method:
GET

NjyyahpB0E.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:

88nC8rMAte.png

Projects

Create a Project

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.

Delete a Project

Deletes an existing project.

Connection Establish a connection to your TimeCamp account.
Project ID Select the Project ID you want to delete.

Update a Project

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.

Watch Projects

Triggers when a new project is created.

Connection Establish a connection to your TimeCamp account.
Limit Enter the maximum number of projects Integromat should return during one scenario execution cycle.

Get a Project

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.
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 Projects

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 Integromat should return during one scenario execution cycle.

Tasks

Create a Task

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.

Update a Task

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.
If there is no Task ID exists to update the details, you will receive an error message, [404] null response.

List Tasks

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 Integromat should return during one scenario execution cycle.

Delete a Task

Deletes an existing task.

Connection Establish a connection to your TimeCamp account.
Task ID Select the Task ID you want to delete.

Watch Tasks

Triggers when a new task is created.

Connection Establish a connection to your TimeCamp account.
Limit Enter the maximum number of tasks Integromat should return during one scenario execution cycle.

Get a Task

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.

Time Entries

List Time Entries

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 Integromat should return during one scenario execution cycle.

Update a Time Entry

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 udpate the activities: 

  • Yes
  • No
  • Not defined

Create a Time Entry 

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.

 

Was this article helpful?
0 out of 0 found this helpful
Menu
  • Features
  • Apps & Services
  • Templates
  • Pricing
  • What's new
  • Use cases
Information
  • Terms,  Privacy
  • FAQ
  • Help & Tutorials
  • Community
  • Affiliate Program
  • Blog
Developers
  • Developer Platform
Company
  • About the company
  • Join our team
  • Contact
Follow us
© 2020 Integromat by Celonis. All rights reserved. Integromat® is a registered trademark.
  • English