Redmine Integration Setup

Hubstaff connects seamlessly with the Redmine project management and issue tracking tool.

When your team members track time to Redmine issues/bugs using the Hubstaff app, the time they spent on a task will appear as a time entry on the Spent time section of the task as shown below.

Time tracked to Redmine tasks will be written back as time entries on the Redmine bug/issue page on the “Spent time” section

Here are the steps on how to connect your Redmine account to Hubstaff:

Step 1

First, you’ll have to make sure the correct organization is selected on the top right corner of the page. To get started with the Redmine integration, click on Integrations on the sidebar menu then click on Redmine.

We support Redmine 2.5 or newer.

Step 2

You’ll need to get your API Token (API Access key) from your Redmine Instance and your Redmine instance URL. You will also need to make sure that REST web service (REST API) is enabled on your Redmine instance.

Getting Your Redmine API Token

Below are the steps to enable REST API and obtain your API token at your Redmine instance. Note that you will need Administrator access to complete these steps. Also, note that your Redmine instance may look different depending on what customizations have been made to it.

A. Click on Administration then Settings in your Redmine instance:

B. Click on the Authentication or API tabs to find the option to enable REST API/REST web service. Make sure the box is checked and click Save:

C. Click on My account in your Redmine instance (this link is in the top right corner on default setups, this may vary for you). Then click on Show under API access key to find your API token:


Step 3

Copy the API token and head back to the Hubstaff integration setup. Pick a name for the integration, paste the API token in, and enter your Redmine instance URL. Then click the Create Integration button:


Step 4

Next, you’ll be taken to the project selection screen where you can link all projects or manually choose which projects you need to link from a list.

Step 5

Next, you’ll need to connect users to your integration. Make sure the “Automatically add new users” option is enabled so that all new users added to Hubstaff are automatically added to your integration. You can also choose to “Select all,” “Unselect all,” or manually choose which users you want working on your integration. Click Finish to end the setup.

Step 6

Each added user will receive a confirmation email from Hubstaff on their registered email address. Ask each user to click on the “Connect my Redmine account” button.

They will be taken to the Hubstaff authorize integration page where they can enter their personal Redmine account’s API token. Hit Connect to authorize the integration.

Step 7

Tasks assigned to each user from Redmine will appear on the Hubstaff time tracking application as shown below. Click on the project name, then press the Play button next to the task name to track time to your Redmine issue.


Time tracked to Redmine tasks will be written back as time entries on the Redmine bug/issue page on the “Spent time” section:


When Hubstaff records time to Redmine the default time entry activity is used. If a project disallows that activity from being used, time will not be logged back to the integration until the activity is allowed.

Redmine does not support seconds in their time tracking API. So Hubstaff rounds the seconds. And this means any record that is less than 30 seconds does not get recorded in Redmine.

“Easy Redmine” is not fully supported

Tasks might not sync right away and can take approximately 5 minutes after linking your team for your tasks to populate. Also, please keep in mind that each time you add a new project or user to your project management tool, the integration needs be refreshed in Hubstaff for those changes to take effect, then link those accordingly.

Currently, when you add a new project in the project management third-party provider, you need to access the integrations page in Hubstaff > refresh the projects list > link the new project > assign team members to the Hubstaff project that’s linked to the newly added project.

Tasks cannot be marked as complete from the Hubstaff application as this integration does not support task completion.

This integration supports logging time back to the integration as time entries. To learn more, click here.

Tasks can be completed outside of Hubstaff in the project management tool to have the time synced as well.

  • Was this Helpful ?
  • Yes   No
  • Was this Helpful ?
  • Yes   No