Skip to main content
Connect Rippling as your HRIS to power employee self-service. Once connected, Risotto can look up employee information, retrieve PTO balances, submit time off requests, and view home addresses on file. These tools are controlled by the People Actions settings. Rippling Settings View

​
Install from the Rippling App Shop

Risotto connects to Rippling through the Rippling App Shop. The App Shop handles authentication and Risotto persists OAuth tokens automatically.
1

Start the install

Find the Risotto app in the Rippling App Shop and click Install, or start from the Risotto dashboard at Settings → People → Connect and click Install next to Rippling.
2

Approve the install in Rippling

Sign in to Rippling as an admin if prompted, then approve the requested permissions for the Risotto app. Rippling redirects you back to the Risotto dashboard once approval is complete.
3

Confirm the connection

Back in the Risotto dashboard, sign in if prompted and you’ll land on Settings → People → Connect, where the install finishes automatically. The Rippling row updates to show the integration is connected.
Only Rippling admins can install App Shop apps. If the Install button redirects you to Rippling without an approval screen, ask an admin in your workspace to complete the install.
A Rippling company can only be connected to one Risotto org at a time. If the same Rippling company is already connected to another Risotto org, the install fails with “This Rippling company is already connected to another Risotto org.” Disconnect from the other org first, then retry the install.

​
Requested Permissions

During install, Risotto requests access to the following Rippling data through the App Shop integration:
AccessPurpose
Employee profileLook up name, work email, job title, department, work location, and start date
Home addressRead the home address on file for the requesting employee
Leave balancesRead PTO policy types and balances for each plan the employee is assigned to
Leave requestsRead existing time off requests and submit new ones on the employee’s behalf
Rippling negotiates the exact permission scopes through the App Shop integration during approval. Risotto reads only the fields it needs to fulfill an active request.

​
Data Fields That Sync

Risotto resolves the requesting employee’s Rippling worker record by matching their work email, then reads only the fields required to answer that request.

​
Employee profile (read)

Pulled from the Rippling workers endpoint:
Rippling fieldUsed for
work_emailPrimary identifier matched against the requester’s email
personal_emailSecondary identifier when work_email is missing
display_namePreferred display name in Risotto responses
titleEmployee profile lookups
departmentEmployee profile lookups
locationWork location lookups
start_dateStart date lookups

​
Home address (read only)

Read from the worker’s HOME-typed address record:
Rippling fieldUsed for
street_addressStreet address lines
localityCity
regionState or province
postal_codePostal / ZIP code
countryCountry

​
Time off (read and write)

Rippling stores leave amounts in minutes; Risotto surfaces them in hours.
Rippling endpointUsed for
leave-balancesCurrent balance and policy type for each plan the employee is assigned to
leave-requestsRead recent and upcoming time off requests, and submit a new request with status pending
Unlimited PTO policies don’t track a running balance, so Risotto surfaces those as unlimited rather than a literal number.

​
Supported Actions

Rippling supports the following People Actions:

Get Employee Info

Look up the requesting employee’s profile, title, department, work location, and start date.

Get Home Address

View the home address on file for the requesting employee.

Get PTO Balance

Retrieve balances for each policy type the employee is assigned to.

Request PTO

Submit a time off request for the requesting employee. Requests are created with status pending and follow your Rippling approval flow.
Update Home Address is not supported for Rippling. The Rippling API does not expose address writes, so employee addresses can only be edited in Rippling by the employee or an HR admin.

​
Terminated Employees

When Rippling marks an employee as terminated or deleted, Risotto receives a webhook from Rippling and immediately stops People Actions from running for that employee. Requests from former employees are escalated, even if their Slack account is still active.

​
Disconnecting

To disconnect Risotto from Rippling, click Disconnect on the Rippling row in People Connect. Risotto deletes its stored access and refresh tokens. To fully remove the app from Rippling, an admin should also uninstall the Risotto app from the Rippling App Shop.