Active
This application does not need additional settings. So you can make connection only by using your login credentials or by following the instructions below.
Redirect url
https://boostspace.integromat.celonis.com/oauth/cb/timelyapp

Timely

The Timely integrator. Designed to work with data inside the application.']module[/tooltip]s allow you to create, update, list, retrieve, and delete the events in your Timely account.

Getting Started with Timely

Prerequisites

  • A Timely account

In order to use Timely with Boost.space Integrator, it is necessary to have a Timely account. If you do not have one, you can sign up using your Google account or create a Timely account at app.timelyapp.com/join.

Connecting Timely to Boost.space Integrator

1. Go to Boost.space Integrator and open the Timely module’s Create a connection dialog.

61f27ce1e6607.gif

2. Enter a name for the connection and click Continue.

3. Confirm the access by clicking Authorize.

61f27ce42cfbe.png

The connection has been established.

Events

Search Events

Searches for events or lists them all.


Connection
Establish a connection to your Timely account.

Account ID
Select the Account ID whose event you want to search.

Search By
Select the option by which you want to search the events:


  • Projects

  • User

  • All

Project ID
Select the Project ID whose events you want to search.

User ID
Select the User ID whose events you want to search.

Filter
Select the option by which you want to filter the events:


  • All

  • Planned

  • Logged

Since
Enter the date to search the events that are started on or after the specified date. For example, 2020-08-18

Up to
Enter the date to search the events that are ended on or before the specified date. For example, 2020-08-18

Day
Enter the date for which you want to search for the events. For example, 2020-08-18

Limit
Set the maximum number of events Boost.space Integrator should return during one scenario execution cycle.

Get an Event

Returns an event.


Connection
Establish a connection to your Timely account.

Account ID
Select the Account ID whose event details you want to retrieve.

Event ID
Select the Event ID whose details you want to retrieve.

Create an Event

Creates an event.


Connection
Establish a connection to your Timely account.

Account ID
Select the Account ID for which you want to create the event.

Day
Enter the day on which you want to create the event. For example, 2020-08-18

Hours
Enter the number of hours the event will happen. Enter a value between 0 to 12.

Minutes
Enter the number of minutes the event will happen. Enter a value between 0 to 60.

Create Event On
Select the option to create the event:


  • Project

  • User

  • Own Preferences

Project ID
Select the Project ID with which you want to associate the event.

User ID
Select the User ID to associate with the event.

Estimated Hours
Enter the number of hours estimated for the event to happen.

Update an Event

Updates a specified event.


Connection
Establish a connection to your Timely account.

Account ID
Select the Account ID for which you want to create the event.

Event ID
Select the Event ID whose details you want to update.

Day
Enter the day on which you want to create the event.

Hours
Enter the number of hours the event will happen. Enter a value between 0 to 12.

Minutes
Enter the number of minutes the event will happen. Enter a value between 0 to 60.

Estimated Hours
Enter the number of hours estimated for the event to happen.

Estimated Minutes
Enter the number of minutes estimated for the event to happen.

From
Enter the date the event starts from. For example, 2017-05-26T10:00:00+05:30

To
Enter the date the events end on. For example, 2017-05-26T10:00:00+05:30

Note
Enter additional information about the event you would like to mention.

Project ID
Select the Project ID with which you want to associate the event.

Labels
Select the appropriate labels for the event.

External ID
Enter the External ID which can be used to reference external resource IDs to Timely resources and should be alphanumeric. The External ID can have a maximum of 512 characters.

Start a Timer

Starts timer for an event.


Connection
Establish a connection to your Timely account.

Account ID
Select the Account ID whose event’s timer you want to start.

Event ID
Select the Event ID whose timer you want to start.

Stop a Timer

Stops timer for an event.


Connection
Establish a connection to your Timely account.

Account ID
Select the Account ID whose event’s timer you want to stop.

Event ID
Select the Event ID whose timer you want to stop.

Delete an Event

Deletes a specified event.


Connection
Establish a connection to your Timely account.

Account ID
Select the Account ID whose event you want to delete.

Event ID
Select the Event ID whose event you want to delete.

Other

Make an API Call

Performs an arbitrary authorized API call.


Connection
Establish a connection to your Timely account.

URL
Enter a path relative to https://api.timelyapp.com/. For example: /1.1/accounts

For the list of available endpoints, refer to the Timely 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 Projects

The following API call returns all the projects from your Timely account:

URL:/1.1/{account_id}/projects

Method:GET

61f27ce51feb7.png

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

61f27ce61a3e1.png

 


Do you need help with something specific regarding Timely?

We are here for you.

Get support on the road to success from real experts.

We will help you set up your business processes, create connections from your current IT stack, and set up data analysis.

  • Chat, phone & e-mail
  • Support teams across the world
  • 2 hours average response time
Get in touch