Rippling integration
Hires and milestones from Rippling, celebrated properly.
New hires, anniversaries, title changes, headcount by department and a departures count from Rippling. Never pay, compensation, bank or tax data.
Milestones
Elena Rossi marks five years at Northwind
Elena has managed Silverline Bank since its first seat. Tom Lindqvist called her “the reason our biggest customers stay.”
In the paper
What Rippling brings to the paper
What we read
- New hiresOn by default
Workers whose start date falls in the window: name, title, department.
- Departures (count only)On by default
How many people left in the window, as one number. Never names or reasons.
- Work anniversariesOn by default
Whole-year anniversaries of start dates that fall in the window.
- Title changesOn by default
People whose current title took effect in the window (promotions and role changes). The previous title isn't available.
- Headcount by departmentOn by default
Active workers per department, plus the company total.
Beats it covers
- People
- By the numbers
Beats feed sections of your paper. You decide which sections run, in what order, and with what house rules.
How you connect
A read-only API key you paste in
Rippling → Tools → Developer → API Tokens → Create API token (scopes: workers.read, users.read, departments.read, companies.read).
Read the Rippling setup guideWhat we never do
- Write, edit or delete anything
- Train models on your data
- Keep raw content longer than your retention setting
- Follow instructions found inside your data
Permissions, and why we ask
The exact scopes Paperbeam requests from Rippling. Nothing more.
| Scope | Why we need it |
|---|---|
| workers.read | Start/end dates, titles, departments and status of workers (compensation is never expanded) |
| users.read | Names and work emails of the people in hire, anniversary and title-change stories |
| departments.read | Department names for filters and headcount by department |
| companies.read | Company name for the connection label |
| employment-types.read | Optional: tell employees from contractors |
Pairs well with
All integrationsConnect Rippling tonight. Read about it tomorrow.
Paperbeam reads overnight and delivers your company’s paper by 7:30, by email, Slack, Teams, Google Chat or Roam.

