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
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
connection that App Connect uses to connect to your private
network. This list is populated with the names of private network connections that are created from
the Private network connectionspage in the Designer instance. You see this field only if a switch server is configured for this Designer instance. For more information, see Connecting to a private network from App Connect Designer. (In App Connect Designer 12.0.10.0-r1 or earlier instances that include this field, the display name is shown as Agent name.) |
- Log in to Toggle Track account.
- Click the PROFILE icon on the side bar, and then select
Profile settings.
The My Profile page appears.
- Under the API Token section, click the field to reveal the API token.
- Copy the API Token value and save it somewhere safe.
To connect to a Toggl Track endpoint from the App Connect Designer Catalog page for the first time, expand Toggl Track, then click Connect.
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 Catalog 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 Catalog page of the App Connect Designer.
For some applications, the events and actions in the catalog 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 |