Table of Contents
Integration with Foresight - How It Works
Before Starting - Important Information
Step-by-Step Guide
Configure Clockify
Configure Foresight
Syncing Work Logs from Clockify
Additional Questions
Can I sync multiple workspaces in Foresight?
Can I sync multiple projects in Foresight?
Why don’t I see my project structure from Clockify?
What does "prevent new assignment creation" mean?
What does "trim assignments to work logs" mean?
What does "clear data" mean?
Do I need to sync new work logs manually? How often are work logs synchronized?
Integration with Foresight Connect - How It Works
The integration allows you to sync work logs entered in Clockify with Foresight Connect. You can easily connect selected projects in Clockify with projects in Foresight and synchronize work logs based on the email addresses of your teammates as registered in Foresight.
Before Starting - Important Information
To integrate Foresight with Clockify, you must have Administrator access on both platforms.
To sync a specific person's work logs, they need to be added as a Manager or Employee in Foresight, with the same email address used in Clockify.
Step-by-Step Guide
1. Log in to Foresight and navigate to the Integrations tab in Administrator mode.
2. Locate the Clockify logo and click the Install button on the right side of the screen. Log in to your Clockify account.
Configure Clockify
- Go to https://clockify.me/user/settings or click on your profile and select Profile settings
- Scroll down to the API section and click the Generate button.
- Confirm by clicking again.
- Copy the generated API key and go back to Foresight.
Configure Foresight
- Paste the generated API key into Foresight and click the Apply configuration button.
- Once done, you should see a confirmation that the integration has been successfully installed.
Syncing Work Logs from Clockify
To sync work logs from Clockify, link projects in Foresight with the corresponding projects in Clockify:
- Switch to the Manager role in Foresight.
- Add a new project or open an existing one.
- Locate Integration Settings on the right side of the Project Page and click on it.
- Check the box next to the Clockify logo.
- In the Select Workspaces field, provide the names of the workspace(s) you want to integrate.
- In the Select Projects field, provide the names of the project(s) you want to integrate.
- Choose the starting date for syncing work logs and click Reset and sync all work logs.
- Wait for the synchronization to complete. If any team members are missing, Foresight will notify you. Add missing team members as Managers or Employees in Foresight and provide their email addresses.
Voilà! Your integration is now fully enabled. Tracking work logs in Foresight is a breeze!
Additional Questions
Can I sync multiple workspaces in Foresight?
Yes! You can sync as many workspaces as you want for a single project in Foresight. Simply select multiple workspaces in the Select Workspaces field in Integration Settings.
Can I sync multiple projects in Foresight?
Yes! You can sync as many projects as you want for a single project in Foresight. Simply select multiple projects in the Select Projects field in Integration Settings.
Why don’t I see my project structure from Clockify?
Foresight only syncs work logs. Tasks, phases, issues, and other project structures are not synchronized. To create an advanced project structure, set it up directly in Foresight.
What does "prevent new assignment creation" mean?
This feature ensures that Foresight only syncs work logs for people already added to a specific project.
Example:
If Bobby and Sam log work in Clockify for Project A, and you created Project A in Foresight but added only Bobby, enabling "prevent new assignment creation" will sync only Bobby's work logs. Sam's logs will not sync since he wasn’t added to Project A in Foresight.
What does "trim assignments to work logs" mean?
This feature adjusts assignment durations to match the dates of the first and last work logs synced from Clockify. By default, Foresight sets assignment durations to the length of the project.
Example:
If Bobby works on Project A from February 1 to March 19, and Project A in Foresight runs from January 1 to September 22:
- Without "trim assignments to work logs," Bobby's assignment will span the full project duration.
- With "trim assignments to work logs," Bobby's assignment will be limited to February 1 through March 19.
Hint: If Bobby logs work only on February 1 and March 19, Foresight will create a single assignment spanning those dates instead of two separate assignments.
What does "clear data" mean?
This deletes all previously synced work logs.
Do I need to sync new work logs manually? How often are work logs synchronized?
No, you don’t. Foresight automatically syncs work logs every 24 hours, so you can rest assured that your data is always up to date.