How to use IBM App Connect with Toggl Track
Toggl Track is a time-tracking software for businesses and freelancers. It can track time spent on projects and analyze productivity.
- App Connect Enterprise as a Service connector
-
Local
connector in containers (Continuous Delivery release) 12.0.12.0-r1 or later -
Local connector in containers (Long Term Support Cycle-2 release)
Connecting to Toggl Track
Complete the connection fields that you see in the App Connect Designer Catalog page or flow editor. If necessary, work with your Toggl Track administrator to obtain these values.
Toggl Track connection fields:
| Authorization type | Connection fields | Applicability |
|---|---|---|
| BASIC | Server URL | App Connect Enterprise as a Service and App Connect in containers |
| Username | ||
| Password | ||
| Allow self-signed certificates | ||
| Override server URL | ||
| Private network connection | ||
| API KEY | Server URL | App Connect Enterprise as a Service and App Connect in containers |
| API token | ||
| Allow self-signed certificates | ||
| Override server URL | ||
| Private network connection |
| Connection field | Description |
|---|---|
| Server URL | Select the URL for the API server that makes runtime calls. |
| API token | Specify the API token that you use to access Toggl Track. |
| Username | Specify the username that is authorized to access Toggl Track. |
| Password | Specify the password for the username. |
| Allow self-signed certificates | Set to true or false. Set to true if you want to be able to accept self-signed certificates that are trusted and used only in a nonproduction environment. The default is false. |
| Override server URL | Required if you want to connect to an endpoint in a private network by using the private network client, or if you want to override the server URL. Specify an override value for the host and port for the connector in the format <http or https>://<host_name>:<port>. If you are not using the private network client or do not require an override, leave this field blank. |
| Private network connection | Select the name of a private network agent that App Connect uses to connect to your private network. This list is populated with the names of private network agents that are created on the Private networks page. For more information, see Connecting to a private network. |
To obtain the connection values for Toggl Track, see Obtaining connection values for Toggl Track.
To connect to a Toggl Track endpoint from the App Connect Designer Catalog page for the first time, expand Toggl Track, then click Connect. For more information, see Managing accounts.
Before you use the account that is created in App Connect in a flow, rename the account to something meaningful that helps you to identify it. To rename the account on the Applications and APIs page, select the account, open its options menu (⋮), then click Rename Account.
General considerations
Before you use App Connect Designer with Toggl Track, take note of the following considerations:
- (General consideration) You can see lists of the trigger events and
actions that are available on the Applications and APIs page of the App Connect Designer.
For some applications, the events and actions depend on the environment and whether the connector supports configurable events and dynamic discovery of actions. If the application supports configurable events, you see a Show more configurable events link under the events list. If the application supports dynamic discovery of actions, you see a Show more link under the actions list.
- (General consideration) If you are using multiple accounts for an application, the set of fields that is displayed when you select an action for that application can vary for different accounts. In the flow editor, some applications always provide a curated set of static fields for an action. Other applications use dynamic discovery to retrieve the set of fields that are configured on the instance that you are connected to. For example, if you have two accounts for two instances of an application, the first account might use settings that are ready for immediate use. However, the second account might be configured with extra custom fields.
Events and Actions
Toggl Track events
These events are for changes in this application that trigger a flow to start completing the actions in the flow.
Show more configurable events: Events that are shown by default are pre-configured by using optimized connectivity. More items are available after you configure events that can trigger a flow by polling this application for new or updated objects. For more information about configurable events, see Configuring polled events to trigger flows.
Toggl Track actions
Your flow completes these actions on this application.
| Object | Action | Description |
|---|---|---|
| Clients | Retrieve clients | Retrieves a list of clients from a workspace |
| Create client | Creates a workspace client | |
| Workspace invites | Create workspace invite | Creates a new invitation for the user |
| Tags | Retrieve tags | Retrieves a list of workspace tags |
| Create tag | Creates workspace tags | |
| Workspace projects | Retrieve workspace projects | Retrieves a list of projects for given workspace |
| Create workspace project | Creates project for given workspace | |
| Workspace users | Retrieve workspace users | Retrieves a list of workspace users |
| Time entries | Retrieve time entries | Retrieves a list of time entries |
| Create time entry | Creates a new workspace time entry | |
| Delete time entry | Deletes a workspace time entry | |
| Update time entry | Updates a time entry | |
| Workspaces | Retrieve workspaces | Retrieves a list of workspaces |
| Create workspace | Creates a workspace within an existing organization |
Examples
Use templates to quickly create flows for Toggl Track
Learn how to use App Connect templates to quickly create flows that complete actions on Toggl Track. For example, open the Templates gallery, and then search for Toggl Track.
Use IBM App Connect to build flows that integrate with Toggl Track.
Read the blog in the IBM Community to learn how to send an invite to fill time entries in Toggl Track for each new employee added to BambooHRBambooHR. Click Read the blog to go to the blog.