Skip to content

Commit f0680a1

Browse files
authored
docs(personio): add recruiting_jobs and recruiting_categories tables, update scopes and sync modes (#21358)
Co-authored-by: inkeep[bot] <257615677+inkeep[bot]@users.noreply.github.com>
1 parent 44f0cb8 commit f0680a1

1 file changed

Lines changed: 19 additions & 10 deletions

File tree

‎contents/docs/cdp/sources/personio.md‎

Lines changed: 19 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -9,13 +9,17 @@ availability:
99
sourceId: Personio
1010
---
1111

12-
The Personio connector syncs your HR data from Personio to PostHog. The following tables are supported:
13-
14-
| Table | Description | Sync mode |
15-
| ------------------ | -------------------------------------- | ---------------------------- |
16-
| persons | Employee profiles and HR data | Full refresh and incremental |
17-
| absence_periods | Employee absences and time-off records | Full refresh and incremental |
18-
| attendance_periods | Employee attendance records | Full refresh and incremental |
12+
The Personio connector syncs your HR and recruiting data from Personio to PostHog. The following tables are supported:
13+
14+
| Table | Description | Sync mode |
15+
| --------------------- | -------------------------------------- | ---------------------------- |
16+
| persons | Employee profiles and HR data | Full refresh and incremental |
17+
| absence_periods | Employee absences and time-off records | Full refresh and incremental |
18+
| attendance_periods | Employee attendance records | Full refresh and incremental |
19+
| salary_bands | Salary band definitions | Full refresh only |
20+
| cost_centers | Cost center definitions | Full refresh only |
21+
| recruiting_jobs | Recruiting job postings | Full refresh only |
22+
| recruiting_categories | Recruiting job categories | Full refresh only |
1923

2024
## Prerequisites
2125

@@ -26,6 +30,9 @@ Before linking Personio, create API credentials in your Personio account:
2630
- `personio:persons:read`
2731
- `personio:absences:read`
2832
- `personio:attendances:read`
33+
- `personio:salary-bands:read`
34+
- `personio:cost-centers:read`
35+
- `personio:recruiting:read`
2936
3. Note down your **Client ID** and **Client secret**
3037

3138
<CalloutBox icon="IconWarning" title="Whitelist employee attributes" type="caution">
@@ -47,18 +54,20 @@ The data warehouse then starts syncing your Personio data. You can see details,
4754

4855
## Sync modes
4956

50-
Personio tables support both full refresh and incremental syncing:
57+
Personio tables support full refresh syncing, and some tables also support incremental syncing:
5158

5259
- **Full refresh** – Re-imports all records from Personio on every sync
53-
- **Incremental** – Only imports records modified since the last sync using `updated_at` filtering
60+
- **Incremental** – Only imports records modified since the last sync using `updated_at` filtering (available for persons, absence_periods, and attendance_periods)
5461

55-
When you enable incremental sync for a table:
62+
When you enable incremental sync for a supported table:
5663

5764
1. The first sync performs a full import to establish a baseline.
5865
2. Subsequent syncs only fetch records modified since the last sync.
5966

6067
Incremental syncing is more efficient for large Personio accounts, reducing sync time and API usage. If a sync is interrupted, it resumes from where it left off.
6168

69+
Tables without incremental support (salary_bands, cost_centers, recruiting_jobs, recruiting_categories) always perform a full refresh.
70+
6271
## Configuration
6372

6473
<SourceParameters />

0 commit comments

Comments
 (0)