Skip to main content

Rippling Integration

Connect Blissbook to Rippling for nightly employee sync and single sign-on. Covers setup, who/when to sync, and how to re-install.

Written by Diane Marshall

Blissbook's Rippling integration is both an employee sync and SSO in one.

If you're using any other HRIS/AD system and you want to integrate with Blissbook, please read this help article.

What it does

Employee sync

Upon installation, your organization members in Blissbook will be replaced by your employee list from Rippling. All active org members in Blissbook who are not in Rippling will be archived in Blissbook. Going forward, the integration will keep those org members in Blissbook in sync with the ones you chose to sync over from Rippling on a nightly basis.

For an employee to be properly synced over from Rippling, they must have a valid work email address. Also, if you set Blissbook to sync employees on their hire date, their hire date must be the current day or earlier.

Rippling single sign-on

Rippling SSO enables users to sign in to Blissbook with their Rippling credentials and lets users click the Blissbook button in Rippling without having to log in again.

Use another SSO option in addition to Rippling

  1. Open your settings page in Blissbook.

  2. Refresh the page once the Rippling installation is complete.

  3. Click the Edit button next to Via Single Sign-On (SSO).

  4. Choose another SSO provider and complete that setup per our instructions.

Multiple authentication methods will now show up on your sign in page.

Turn off Rippling SSO

If you want to only use another SSO provider:

  1. Open your settings page in Blissbook.

  2. Refresh the page once the Rippling installation is complete.

  3. Click the Edit button next to Via Single Sign-On (SSO).

  4. Click the Edit button in the Rippling box.

  5. Click the Uninstall button.

Note: If users click the Blissbook button in Rippling, they will not automatically be signed in to Blissbook and will have to go through your other SSO provider or Blissbook's email sign-in process to sign in.

Note: If you turn off Rippling SSO and change your mind, you will have to uninstall the Rippling integration in Blissbook, delete/remove Blissbook from Rippling, and then start over.

How to set it up

Requirements

The Blissbook + Rippling integration requires you to have the Rippling App Management package in your Rippling subscription. You can learn more about that here.

Please contact your Rippling sales rep to learn more. You cannot purchase access to singular apps; you must subscribe to the entire package.

Get started

  1. Go to the Settings page in the side nav.

  2. Switch to the Employee List Sync tab.

  3. Click Contact Sales or send an email to support@blissbook.com if you want to sync your Rippling data.

  4. Once we have reached back out to you, you will have access to the HRIS integrations on that page. Beside Using Rippling?, click Connect it here and follow the instructions on screen.

Employee List Sync tab in Settings with the Rippling connection option

The screenshot shows the Employee List Sync tab in Settings with the Rippling connection option.

Who to sync

During the setup process, you'll be asked who you want to sync. This defines the master set of people who get synced over. You will have the opportunity to assign an Employment Type group to the people synced over.

Rippling sync setup screen where you select which people to sync

The screenshot shows the Rippling sync setup screen where you select which people to sync.

If you need to personalize content based on whether someone is an Employee or a Contractor, you can do that within Blissbook. In this case you should sync employees and contractors.

When to sync

You'll also be asked when people should be synced over to Blissbook.

Timing options for when people should be synced from Rippling to Blissbook

The screenshot shows the timing options for when people should be synced from Rippling to Blissbook.

When a new employee is synced over, they may receive an invitation email (if you have automated invitations turned on).

How to re-install an existing Rippling integration

You may need to re-install your Rippling integration for a few reasons, and each reason has its own process.

Refresh the integration due to an expired token

Blissbook's access token to your data in Rippling may expire due to unexpected circumstances. The only way for Blissbook to resolve this is to get a new access token, which can only be obtained when you first install the integration. This means you need to uninstall and reinstall Rippling. Your employees will not be archived and re-added, nor will they receive any sort of notification.

1) Uninstall

First, uninstall the Blissbook integration from Rippling:

  1. Go to https://app.rippling.com/app-shop/app/blissbook.

  2. Click the Installed button in the top right.

  3. Click the Settings tab.

  4. Click Uninstall in the left text nav.

  5. Click the red Uninstall Blissbook button.

  6. Click Skip.

  7. Type DELETE.

  8. Click the I understand, Uninstall Blissbook button.

Now Rippling's connection to Blissbook is severed.

Next, sever Blissbook's connection to Rippling:

  1. In Blissbook, click Settings in the main nav on the left side of the page.

  2. Switch to the Employee List Sync tab.

  3. Click the purple Edit Rippling Integration button.

  4. Click the red Uninstall button.

Note: This does not remove people from your organization in Blissbook or change any of their data. It just clears Blissbook's link to Rippling.

2) Re-install

You are now free and clear to re-install. Scroll back up this help article to the How to set it up section and follow the instructions for a fresh install.

Once complete, you may need to adjust the groups that are being synced over:

  1. In Blissbook, click Settings in the main nav on the left side of the page.

  2. Switch to the Employee List Sync tab.

  3. Click the purple Edit Rippling Integration button.

  4. Check the Rippling fields whose values you'd like to bring into Blissbook as groups.

  5. Click Save Changes.

Note: An isManager group will be automatically created and populated for managers.

Get Rippling SSO back

If you uninstalled Rippling SSO by accident and you want to get it back, you will need to completely uninstall the Rippling-Blissbook connections on both sides, then reinstall from scratch.

1) Uninstall

First, uninstall the Blissbook integration from Rippling:

  1. Go to https://app.rippling.com/app-shop/app/blissbook.

  2. Click the Installed button in the top right.

  3. Click the Settings tab.

  4. Click Uninstall in the left text nav.

  5. Click the red Uninstall Blissbook button.

  6. Click Skip.

  7. Type DELETE.

  8. Click the I understand, Uninstall Blissbook button.

Now Rippling's connection to Blissbook is severed. To get the SSO back, sever Blissbook's connection to Rippling:

  1. In Blissbook, click Settings in the main nav on the left side of the page.

  2. Switch to the Employee List Sync tab.

  3. Click the purple Edit Rippling Integration button.

  4. Click the red Uninstall button.

Note: This does not remove people from your organization in Blissbook or change any of their data. It just clears Blissbook's link to Rippling.

2) Re-install

You are now free and clear to re-install. Scroll back up this help article to the How to set it up section and follow the instructions for a fresh install.

Once complete, you may need to adjust the groups that are being synced over:

  1. In Blissbook, click Settings in the main nav on the left side of the page.

  2. Switch to the Employee List Sync tab.

  3. Click the purple Edit Rippling Integration button.

  4. Check the Rippling fields whose values you'd like to bring into Blissbook as groups.

  5. Click Save Changes.

Note: An isManager group will be automatically created and populated for managers.

Upgrade your HRIS sync

Occasionally Blissbook upgrades the HRIS sync part of the Rippling-Blissbook integration. When this happens, you may need to re-install the integration to take advantage of new features. We will typically tell you when you need to do this.

1) Uninstall the Blissbook integration from Rippling

  1. Go to https://app.rippling.com/app-shop/app/blissbook.

  2. Click the Installed button in the top right.

  3. Click the Settings tab.

  4. Click Uninstall in the left text nav.

  5. Click the red Uninstall Blissbook button.

  6. Click Skip.

  7. Type DELETE.

  8. Click the I understand, Uninstall Blissbook button.

Now Rippling's connection to Blissbook is severed.

2) Re-install Rippling into Blissbook

Re-install Rippling into Blissbook and replace the current HRIS sync with the new version from Rippling:

  1. Go back to https://app.rippling.com/app-shop/app/blissbook.

  2. Click the yellow Connect Account button.

  3. Click the Restart button if you get a You've partially completed Blissbook Install setup pop-up (you may need to click it twice).

  4. Choose the I'm the Blissbook admin, I'll install it option.

  5. Click Authorize.

  6. Work through the next setup steps, choosing the options that fit what you'd like to happen, and click Continue to advance through the process.

  7. When you get to the Connect your Blissbook account to Rippling step, click Continue.

  8. This should bring you to a Re-Install Rippling page in Blissbook.

  9. Click the purple Re-Install Rippling button.

3) Confirm the sync page

At this point it should bring you to your sync page in Blissbook. If it doesn't:

  1. Open Blissbook, click Settings in the main nav on the left side of the page.

  2. Switch to the Employee List Sync tab.

  3. Click the purple Edit Rippling Integration button.

  4. Check the Rippling fields whose values you'd like to bring into Blissbook as groups.

  5. Click Save Changes.

Note: An isManager group will be automatically created and populated for managers.

You're done. If you or your IT group has questions, please contact us at support@blissbook.com.

Did this answer your question?