Rippling Integration Setup

Documentation Index

Fetch the complete documentation index at: https://help.ruddr.io/llms.txt

Use this file to discover all available pages before exploring further.

Integrating Rippling with Ruddr provides numerous benefits as outlined in the Rippling Integration Overview article. To install the Rippling integration, simply follow the steps below. Note that you must be a Ruddr Workspace Admin to install integrations in Ruddr. Additionally, the member setting up this integration must also be Rippling administrator.

​

Step 1: Install the Ruddr App in Rippling

Installing the Rippling integration involves the installation and configuration of the Ruddr application from within the Rippling App Shop. This installation can be initiated from within Ruddr or from within Rippling.

​

Initiating the Installation from Ruddr

To get to the Integrations area of Ruddr, simply click on the Settings main nav bar option and then select the Integrations menu option (see Integrations for more information). The Integrations screen is separated into two sections which are Active Integrations and Available Integrations. If you have yet to set up the Rippling integration, it will be listed in the Available Integrations section. Simply click on the Install button at the bottom of the integration widget (Figure 1). This will redirect you to Rippling, where the installation will continue at Step 2 - Configure Ruddr App in Rippling. Figure 1 - Click Install to Begin the Rippling Integration in Ruddr

​

Initiating the Installation from Rippling

In Rippling, navigate to the App Shop. A link to the App Shop can typically be found towards the bottom of the left navigation menu in Rippling (Figure 2). Figure 2 - Navigate to the App Shop in Rippling to Install the Ruddr App Once in the App Shop, you can either search for “Ruddr” or you can find Ruddr listed under the Collaboration > Productivity category (Figure 3). Figure 3 - Locate the Ruddr App in the Rippling App Shop by Search or Within the Productivity Category On the Ruddr app overview page in Rippling, click on the Connect Account button (Figure 4) to begin the installation. The installation can now continue with Step 2 - Configure Ruddr App in Rippling. Figure 4 - Begin the Installation of the Ruddr App in Rippling by Clicking the Connect Account button

​

Step 2: Configure Ruddr App in Rippling

As a next step in Rippling, you will need either proceed with installing the Ruddr app as a Ruddr workspace administrator or designate a specific Ruddr admin for the installation (Figure 5). If you are a Ruddr admin, specify that you will install it and click the Continue button at the bottom-right of the screen to proceed to authorize the Ruddr app. Figure 5 - As a Ruddr Admin, Proceed with Installing the Ruddr App in Rippling

​

Permissions Authorization

Upon indicating that you are a Ruddr administrator, you will be prompted (Figure 6) to authorize Ruddr to access specific Rippling information. Review the permissions, then click the Authorize button at the bottom of the screen. Figure 6 - Authorize Ruddr to Access Rippling Information

​

Application Access Rules for Your Organization

Upon authorizing Ruddr to read information for your organization, you will be prompted (Figure 7) by Rippling to assign access to people within your organization. Choose the option that best applies for your organization and click the Continue button to proceed. Figure 7 - Specify the People in Your Organization Needing Access to the Ruddr App in Rippling As a secondary step in establishing access to the Ruddr app in Rippling, you will need to specify (Figure 8) at what point the access should take effect. Choose the appropriate option for your organization and click Continue to proceed. Figure 8 - Configure Access to the Ruddr App in Rippling

​

Finalize the Installation / Connection in Rippling

After authorizing access to the Ruddr app in Rippling, you will be prompted (Figure 9) to finalize the connection. Click on the Continue button to proceed and be redirected to Ruddr if you do not have an active Ruddr session in your browser. Figure 9 - Finalize the Connection by Logging in to Ruddr After establishing an active, logged-in session in Ruddr, you will be redirected to Rippling to complete the process there. You can either wait for the installation to complete (Figure 10) or click the Continue button to go directly to the Ruddr app management page in Rippling. Figure 10 - As the Final Step is Completed, Continue to the Ruddr App Overview Page in Rippling With the Ruddr app installed and configured in Rippling, it is now time to configure the integration in Ruddr: Step 3 - Configure the Rippling integration in Ruddr.

​

Step 3 - Configure the Rippling Integration in Ruddr

There are a number of Rippling configuration settings in Ruddr, available from the Settings screen (Figure 11).

• Member Settings
• Time Off Settings
• Sync Settings

Figure 11 - Rippling Integration Settings in Ruddr This screen is immediately available after finalizing the installation of the Ruddr app in Rippling and is accessible by clicking the Settings button on the Rippling integration widget (Figure 12) on the Integrations screen in Ruddr workspace settings once the integration is enabled. Figure 12 - Rippling Integration Widget when Enabled The following sections will cover each of these groups of settings.

​

Member Settings

In the Member Settings section (Figure 13), you can specify how you want the integration to manage Ruddr workspace members and relevant member data fields. Figure 13 - Member Settings Clicking the Change Settings button will open the Member Settings drawer (Figure 14). Figure 14 - Manage Member Settings for the Ruddr / Rippling Integration The following Member Settings are available:

• Invite Created Members - by default, the integration is set to create new workspace members in Ruddr but not send invitations to those members. By toggling this setting to On, the integration will automatically send invitations to Ruddr members when they are created by the Rippling integration. Note that when members are created in Ruddr, their Security Role is set to the default Security Role in the workspace.
• Create Billable Members - by default, Ruddr members that are created by the Rippling integration are set as non-billable workspace members in Ruddr. Changing this to On will configure all newly created Ruddr members as billable in your workspace.
• Update Member Status - This setting controls whether or not the integration will automatically update a Ruddr member’s status (Active or Inactive) based on the employee status in Rippling. If an employee in Rippling is terminated, and this setting is set to On, the integration will automatically deactivate the member in the Ruddr workspace. Conversely, if an inactive employee in Rippling is reactivated, or a new employee is created, the integration will set this member’s workspace status to Active in Ruddr. By default, this setting is set to Off.
• Update Member Active Dates - enabling this setting will ensure that the Rippling hire date and termination date will be used as the Ruddr member’s active date and inactive date, respectively.
• Update Member Name - sync the employee name from Rippling to Ruddr members.
• Update Job Title - this setting allows the integration to sync an employee’s job title from Rippling to Ruddr members. If the Job Title does not exist as a record in Custom Data, then Ruddr will create the Job Title record.
• Update Manager - if the email of the employee’s manager maps to a Ruddr member, the manager will be set on the employee’s member record.
• Update Internal ID - enabling this setting will sync the employee’s Rippling employee ID to the Internal ID field on the member profile in Ruddr.
• Update Member Email - if you want to keep the email address used in Rippling as the member’s email in Ruddr, set this setting to On.
• Member Mapping - This setting controls how the integration maps Rippling employees to Ruddr members. Provided your workspace members use the same email address in both systems, you can leave this set to Automatic. Setting this to Manual requires you to manually map Rippling employees to Ruddr members. The default setting is Automatic.

NOTE: In order for Ruddr to create a member, an email address must be found in Rippling. There are multiple email values on an employee record in Rippling; the email must be entered on the “Work Email” field in order to be used by Ruddr in creating a member. When Ruddr is set to automatically map members with Rippling, the Member Settings section (Figure 13) will present a Preview Members button. Clicking this button will open up the Member Matching drawer (Figure 15), which will display the Ruddr member and email address in the left column, and the Rippling employee and email address in the right column. In this drawer, you will be able to see the following:

• Successfully mapped members
• Members found in Ruddr but not in Rippling
• Members found in Rippling but not in Ruddr

When automatic mapping is set, the integration will automatically create a Ruddr member when a Rippling employee has no corresponding member in Ruddr. Figure 15 - Member Matching Preview When you select to manually set the Member Mapping, the Member Settings section (Figure 13) will display an Edit Mappings button. Clicking the Edit Mappings button will present you with a Member Matching drawer (Figure 16) that will allow you to map each member in Ruddr to the corresponding employee in Rippling. Figure 16 - Manually Map Ruddr Members to Rippling Users

​

Time Off Settings

In the Time Off Settings section (Figure 17), you can specify how you want to manage time off time entries from Rippling. Figure 17 - Time Off Settings The following Time Off Settings are available:

• Import Start Date - Setting this date establishes the first date of time off requests that Ruddr will import from Rippling. You may prefer to import time off time entries beginning on the date the integration is setup.
• Create Time Off Types - The default setting is On. In this case, the integration will map time off types between the two systems when the time off type name is identical. If no match is found, the time off type will be created in Ruddr and the time off entry will be imported. If this setting is switched to Off and the integration does not find a matching time off type, the time off entry will not be imported.
• Update Time Off Notes - Ruddr will sync any description associated with a time off request in Rippling as Notes on the time entry that gets created. If you do not want these notes to be available on the time entries in Ruddr, you can change this setting to Off.
• Time Off Type Mapping - In Ruddr and Rippling, you can specify the types of time off available to employees. For example, you may allow employees to enter Vacation, Sick Leave, or Holiday time. The integration allows for Rippling time off types to be mapped to Ruddr time off types. Setting this to Manual will allow you to control the mappings between the two systems. The default setting is Automatic.

When the integration is set to automatically map time off types with Rippling, the Time Off Settings section (Figure 17) will present a Preview Time Off Types button. Clicking this button will open up the Time Off Types Matching drawer (Figure 18), which will display the Ruddr time off type in the left column and the Rippling time off type in the right column. In this drawer, you will be able to see the following:

• Successfully mapped types
• Time off types found in Ruddr but not in Rippling
• Time off types found in Rippling but not in Ruddr

Figure 18 - Time Off Type Matching Preview When you choose to manually set the Time Off Type Mapping, the Time Off Settings section (Figure 17) will display an Edit Mappings button, as shown below (Figure 18). Figure 18 - Edit Time Off Type Mappings when the Setting is Manual Clicking the Edit Mappings button will present a Time Off Type Matching drawer (Figure 19) that will allow you to map each time off type in Rippling to any time off type in Ruddr. Note that multiple Rippling time off types can be mapped to a single Ruddr time off type. This allows you to consolidate multiple Ripping time off types into a single Ruddr time off type. It also provides for a level of data privacy in that what might otherwise be sensitive time off information can be represented in Ruddr as any time off type you choose. Figure 19 - Manually Map Rippling Time Off Types to Ruddr Time Off Types

​

Sync Settings

The final step in the Rippling integration setup is to configure the sync settings. To do this, click the Change Settings button in the Sync Settings section (Figure 20). Figure 20 - Rippling Integration Sync Settings Clicking the Change Settings button will open the Sync Settings drawer (Figure 21). From this drawer, you first specify whether or not you want the sync process to run on an automatic schedule. Although the default setting is Off, you most likely will want this setting turned On. When turned on, Ruddr will sync with Rippling on an hourly basis. Next, you choose whether or not you want Members synchronized to Ruddr as part of this integration. Finally, you specify whether or not you want approved time off requests in Rippling synched to Ruddr time off entries. Figure 21 - Manage Ruddr / Rippling Sync Setting Note that from the Sync Settings section (Figure 20), you can also initiate a manual sync by clicking on the New Manual Sync button. At this point, your Rippling integration is configured and ready to go. But, there are a couple of other areas of the Rippling integration to point out.

​

Imported Data

The Imported Data section (Figure 22) of the Rippling integration settings shows statistics about the data that has been synchronized from Rippling to Ruddr. This section also provides a mechanism to delete time off entries that have been synched from Rippling. Figure 22 - The Imported Data section Displays Statistics Regarding the Integration Clicking the Delete Time Off Entries button will present a dialog (Figure 23), asking you to confirm that you want to delete time entries synched from Rippling. Figure 23 - Confirm your Choice to Delete all Time Entries Created by the Rippling Integration

​

Latest Sync Results / Sync Logs

At the bottom of the Rippling integration settings screen, you will find a log of sync results (Figure 24) for both Manual and Automatic syncs. Clicking on a row in the log will display the details (Figure 25) regarding that synchronization. Viewing these logs can assist the Workspace Admin in evaluating the Ruddr records that have been created by the sync as well as information related to the Member mapping and the Time Off Type mapping. Figure 24 - Detailed Log of Sync Results Figure 25 - List of Results for past Synchronization