Skip to main content
Integrating breathe with RotaCloud

How to set up and use the RotaCloud integration with breathe

James Denham avatar
Written by James Denham
Updated over a week ago

Setting up the integration

Before you start

If you're integrating with breathe using a brand new, empty RotaCloud account, then all employees will be sent over to RotaCloud at the moment of integration. 

When this happens, they will all be sent an invite email, asking them to set up an account with RotaCloud and choose a password. If you would rather this did not happen, add your Employees to RotaCloud before integrating, ensuring that you do not send out invite emails.

You may also not want all of your Employees in breathe to be used in RotaCloud. If this is the case, you will need to exclude them from the sync after the integration has taken place. Please see below for more info on excluding staff from the sync.

If you're integrating with breathe using a RotaCloud account you've been using before, there are a couple of things to bear in mind:

  • Before setting up the integration, ensure that all employees' names match on both systems, and that each employee's email address is registered in RotaCloud. If there are discrepancies, the integration will create duplicate employees in RotaCloud.

  • When the integration is set up, all existing Leave records in RotaCloud will be deleted and replaced with the Leave calendar from breathe.

Step 1: Create your API key

In RotaCloud, click Settings (the cog icon) on the top-right of the blue navigation bar, then select the API Keys tab.

Next, click the blue Plus button to create a new API key. Enter a name of the API key (something like 'breathe' is best) and then click Create.

Step 2: Enter your API key into breathe

Once you have created your API key in RotaCloud, log on to your breathe account. In breathe, select Configure>Settings>RotaCloud.

Here, enter the API key you created in RotaCloud and click 'Enable'.

Step 3: Enter breathe API key into RotaCloud

The final step of the integration is to take the production API key from breathe and enter it into RotaCloud.

To do this, in your breathe account, go to Configure>Settings and select API Setup. Click 'Enable' and then copy the production API key.

Once you have copied this, go to your RotaCloud account and go to Settings>Integrations>breathe and select 'Link Account'.

Enter you API key in the box provided and click 'Link Accounts'

Managing the systems

What should I do in each system?


  • Creation of Employees and assigning of email addresses

  • Managing Leave


  • Rotas

  • Creation of Locations and Roles

  • Assigning employees to Locations and Roles

Other notes

  • It's possible to bulk-delete employees from RotaCloud. However, you will not be able to delete the Admin user.

  • You will not be able to delete your breathe account unless the RotaCloud integration is disabled.

Did this answer your question?