HiBob
What Paperbeam reads from HiBob, the read-only access it asks for and why, filters, and the beats it feeds.
People
Read-only API key
New hires, work anniversaries, title changes, a departures count and who's out today from HiBob. Never pay, compensation, bank or personal data.
What we read
- Hires, work anniversaries and promotions
- Metric values
Only the reporting window of each edition is read. Paperbeam stores derived facts and short excerpts, not copies of your HiBob data, and keeps raw evidence only for your retention period.
Access we ask for, and why
| Scope | Why |
|---|---|
People's fields: Root, Work → View | Names, work emails, titles, departments and start dates (default employee fields; payroll and personal categories are never requested) |
Work → View history | Title changes (work history table) |
Lifecycle (Table) → View history + access to inactive employees | Optional: the departures count |
Time off → who's out | Optional: how many people are out today (counts only) |
All access is read-only. You can revoke it from HiBob at any time, or disconnect the source in Paperbeam.
Connect HiBob
- Go to Sources and choose HiBob.
- Create a service user. Bob → Settings → Integrations → Service users → create a service user, copy its ID and token, then add it to a permission group with read-only People's data permissions. Open HiBob settings.
- Fill in Service user ID and Token, then click Test connection. Paperbeam makes one read-only call and shows the account it reached, or exactly what went wrong.
- Click Connect. The credential is encrypted before it is stored and never shown again. Use Sync now on the source’s page to see what it collects from the last 24 hours, and set filters there.
You need the admin or owner role in Paperbeam, and enough permission in HiBob to grant read access to the data listed above.
To keep specific people, channels or topics out of the paper across all sources, use exclusion rules and the never-mention list in House style.
Beats
HiBob is a source for:
Stories land in whichever of your sections fits them best.