Rippling

Manage employees, leave, departments, and company data in Rippling

Rippling is a unified workforce management platform that brings together HR, IT, and Finance into a single system. Rippling lets companies manage payroll, benefits, devices, apps, and more — all from one place — while automating the tedious manual work that typically bogs down HR teams. Its robust API provides programmatic access to employee data, organizational structure, leave management, and onboarding workflows.

Why Rippling?

  • Unified Employee System of Record: A single source of truth for employee profiles, departments, teams, levels, and work locations — no more syncing data across disconnected tools.
  • Leave Management: Full visibility into leave requests, balances, and types with the ability to approve or decline requests programmatically.
  • Company Insights: Access company activity events, custom fields, and organizational hierarchy to power reporting and compliance workflows.
  • Onboarding Automation: Push candidates directly into Rippling's onboarding flow, eliminating manual data entry when bringing on new hires.
  • Group Management: Create and update groups for third-party app provisioning via SCIM-compatible endpoints.

Using Rippling in Sim

Sim's Rippling integration connects your agentic workflows directly to your Rippling account using an API key. With 19 operations spanning employees, departments, teams, leave, groups, and candidates, you can build powerful HR automations without writing backend code.

Key benefits of using Rippling in Sim:

  • Employee directory automation: List, search, and retrieve employee details — including terminated employees — to power onboarding checklists, offboarding workflows, and org chart updates.
  • Leave workflow automation: Monitor leave requests, check balances, and programmatically approve or decline requests based on custom business rules.
  • Organizational intelligence: Query departments, teams, levels, work locations, and custom fields to build dynamic org reports or trigger actions based on structural changes.
  • Candidate onboarding: Push candidates from your ATS or recruiting pipeline directly into Rippling's onboarding flow, complete with job title, department, and start date.
  • Activity monitoring: Track company activity events to build audit trails, compliance dashboards, or alert workflows when key changes occur.

Whether you're automating new hire onboarding, building leave approval workflows, or syncing employee data across your tool stack, Rippling in Sim gives you direct, secure access to your HR platform — no middleware required. Simply configure your API key, select the operation you need, and let Sim handle the rest.

Usage Instructions

Integrate Rippling into your workflow. Manage employees, departments, teams, leave requests, work locations, groups, candidates, and company information.

Tools

rippling_list_employees

List all employees in Rippling with optional pagination

Input

ParameterTypeRequiredDescription
apiKeystringYesRippling API key
limitnumberNoMaximum number of employees to return (default 100, max 100)
offsetnumberNoOffset for pagination

Output

ParameterTypeDescription
employeesarrayList of employees
idstringEmployee ID
firstNamestringFirst name
lastNamestringLast name
workEmailstringWork email address
personalEmailstringPersonal email address
roleStatestringEmployment status
departmentstringDepartment name or ID
titlestringJob title
startDatestringEmployment start date
endDatestringEmployment end date
managerstringManager ID or name
phonestringPhone number
totalCountnumberNumber of employees returned on this page

rippling_get_employee

Get details for a specific employee by ID

Input

ParameterTypeRequiredDescription
apiKeystringYesRippling API key
employeeIdstringYesThe ID of the employee to retrieve

Output

ParameterTypeDescription
idstringEmployee ID
firstNamestringFirst name
lastNamestringLast name
workEmailstringWork email address
personalEmailstringPersonal email address
roleStatestringEmployment status
departmentstringDepartment name or ID
titlestringJob title
startDatestringEmployment start date
endDatestringEmployment end date
managerstringManager ID or name
phonestringPhone number

rippling_list_employees_with_terminated

List all employees in Rippling including terminated employees with optional pagination

Input

ParameterTypeRequiredDescription
apiKeystringYesRippling API key
limitnumberNoMaximum number of employees to return (default 100, max 100)
offsetnumberNoOffset for pagination

Output

ParameterTypeDescription
employeesarrayList of employees including terminated
idstringEmployee ID
firstNamestringFirst name
lastNamestringLast name
workEmailstringWork email address
personalEmailstringPersonal email address
roleStatestringEmployment status
departmentstringDepartment name or ID
titlestringJob title
startDatestringEmployment start date
endDatestringEmployment end date
managerstringManager ID or name
phonestringPhone number
totalCountnumberNumber of employees returned on this page

rippling_list_departments

List all departments in the Rippling organization

Input

ParameterTypeRequiredDescription
apiKeystringYesRippling API key
limitnumberNoMaximum number of departments to return
offsetnumberNoOffset for pagination

Output

ParameterTypeDescription
departmentsarrayList of departments
idstringDepartment ID
namestringDepartment name
parentstringParent department ID
totalCountnumberNumber of departments returned on this page

rippling_list_teams

List all teams in Rippling

Input

ParameterTypeRequiredDescription
apiKeystringYesRippling API key
limitnumberNoMaximum number of teams to return
offsetnumberNoOffset for pagination

Output

ParameterTypeDescription
teamsarrayList of teams
idstringTeam ID
namestringTeam name
parentstringParent team ID
totalCountnumberNumber of teams returned on this page

rippling_list_levels

List all position levels in Rippling

Input

ParameterTypeRequiredDescription
apiKeystringYesRippling API key
limitnumberNoMaximum number of levels to return
offsetnumberNoOffset for pagination

Output

ParameterTypeDescription
levelsarrayList of position levels
idstringLevel ID
namestringLevel name
parentstringParent level ID
totalCountnumberNumber of levels returned on this page

rippling_list_work_locations

List all work locations in Rippling

Input

ParameterTypeRequiredDescription
apiKeystringYesRippling API key
limitnumberNoMaximum number of work locations to return
offsetnumberNoOffset for pagination

Output

ParameterTypeDescription
workLocationsarrayList of work locations
idstringWork location ID
nicknamestringLocation nickname
streetstringStreet address
citystringCity
statestringState or province
zipstringZIP or postal code
countrystringCountry
totalCountnumberNumber of work locations returned on this page

rippling_get_company

Get details for the current company in Rippling

Input

ParameterTypeRequiredDescription
apiKeystringYesRippling API key

Output

ParameterTypeDescription
idstringCompany ID
namestringCompany name
addressjsonCompany address with street, city, state, zip, country
emailstringCompany email address
phonestringCompany phone number
workLocationsarrayList of work location IDs

rippling_get_company_activity

Get activity events for the current company in Rippling

Input

ParameterTypeRequiredDescription
apiKeystringYesRippling API key
startDatestringNoStart date filter in ISO format (e.g. 2024-01-01)
endDatestringNoEnd date filter in ISO format (e.g. 2024-12-31)
limitnumberNoMaximum number of activity events to return
nextstringNoCursor for fetching the next page of results

Output

ParameterTypeDescription
eventsarrayList of company activity events
idstringEvent ID
typestringEvent type
descriptionstringEvent description
createdAtstringEvent creation timestamp
actorjsonActor who triggered the event (id, name)
totalCountnumberNumber of activity events returned on this page
nextCursorstringCursor for fetching the next page of results

rippling_list_custom_fields

List all custom fields defined in Rippling

Input

ParameterTypeRequiredDescription
apiKeystringYesRippling API key
limitnumberNoMaximum number of custom fields to return
offsetnumberNoOffset for pagination

Output

ParameterTypeDescription
customFieldsarrayList of custom fields
idstringCustom field ID
typestringField type
titlestringField title
mandatorybooleanWhether the field is mandatory
totalCountnumberNumber of custom fields returned on this page

rippling_get_current_user

Get the current authenticated user details

Input

ParameterTypeRequiredDescription
apiKeystringYesRippling API key

Output

ParameterTypeDescription
idstringUser ID
workEmailstringWork email address
companystringCompany ID

rippling_list_leave_requests

List leave requests in Rippling with optional filtering by date range and status

Input

ParameterTypeRequiredDescription
apiKeystringYesRippling API key
startDatestringNoFilter by start date (ISO date string)
endDatestringNoFilter by end date (ISO date string)
statusstringNoFilter by status (e.g. pending, approved, declined)

Output

ParameterTypeDescription
leaveRequestsarrayList of leave requests
idstringLeave request ID
requestedBystringEmployee ID who requested leave
statusstringRequest status (pending/approved/declined)
startDatestringLeave start date
endDatestringLeave end date
reasonstringReason for leave
leaveTypestringType of leave
createdAtstringWhen the request was created
totalCountnumberTotal number of leave requests returned

rippling_process_leave_request

Approve or decline a leave request in Rippling

Input

ParameterTypeRequiredDescription
apiKeystringYesRippling API key
leaveRequestIdstringYesThe ID of the leave request to process
actionstringYesAction to take on the leave request (approve or decline)

Output

ParameterTypeDescription
idstringLeave request ID
statusstringUpdated status of the leave request
requestedBystringEmployee ID who requested leave
startDatestringLeave start date
endDatestringLeave end date

rippling_list_leave_balances

List leave balances for all employees in Rippling

Input

ParameterTypeRequiredDescription
apiKeystringYesRippling API key
limitnumberNoMaximum number of leave balances to return
offsetnumberNoOffset for pagination

Output

ParameterTypeDescription
leaveBalancesarrayList of employee leave balances
employeeIdstringEmployee ID
balancesarrayLeave balance entries
leaveTypestringType of leave
minutesRemainingnumberMinutes of leave remaining
totalCountnumberNumber of leave balances returned on this page

rippling_get_leave_balance

Get leave balance for a specific employee by role ID

Input

ParameterTypeRequiredDescription
apiKeystringYesRippling API key
roleIdstringYesThe employee/role ID to retrieve leave balance for

Output

ParameterTypeDescription
employeeIdstringEmployee ID
balancesarrayLeave balance entries
leaveTypestringType of leave
minutesRemainingnumberMinutes of leave remaining

rippling_list_leave_types

List company leave types configured in Rippling

Input

ParameterTypeRequiredDescription
apiKeystringYesRippling API key
managedBystringNoFilter leave types by manager

Output

ParameterTypeDescription
leaveTypesarrayList of company leave types
idstringLeave type ID
namestringLeave type name
managedBystringManager of this leave type
totalCountnumberTotal number of leave types returned

rippling_create_group

Create a new group in Rippling

Input

ParameterTypeRequiredDescription
apiKeystringYesRippling API key
namestringYesName of the group
spokeIdstringYesThird-party app identifier
usersjsonNoArray of user ID strings to add to the group

Output

ParameterTypeDescription
idstringGroup ID
namestringGroup name
spokeIdstringThird-party app identifier
usersarrayArray of user IDs in the group
versionnumberGroup version number

rippling_update_group

Update an existing group in Rippling

Input

ParameterTypeRequiredDescription
apiKeystringYesRippling API key
groupIdstringYesThe ID of the group to update
namestringNoNew name for the group
spokeIdstringNoThird-party app identifier
usersjsonNoArray of user ID strings to set for the group
versionnumberNoGroup version number for optimistic concurrency

Output

ParameterTypeDescription
idstringGroup ID
namestringGroup name
spokeIdstringThird-party app identifier
usersarrayArray of user IDs in the group
versionnumberGroup version number

rippling_push_candidate

Push a candidate to onboarding in Rippling

Input

ParameterTypeRequiredDescription
apiKeystringYesRippling API key
firstNamestringYesCandidate first name
lastNamestringYesCandidate last name
emailstringYesCandidate email address
phonestringNoCandidate phone number
jobTitlestringNoJob title for the candidate
departmentstringNoDepartment for the candidate
startDatestringNoStart date in ISO 8601 format (e.g., 2025-01-15)

Output

ParameterTypeDescription
idstringCandidate ID
firstNamestringCandidate first name
lastNamestringCandidate last name
emailstringCandidate email address
statusstringCandidate onboarding status

On this page

Start building today
Trusted by over 100,000 builders.
The open-source platform to build AI agents and run your agentic workforce.
Get started