Personio Recruiting

Overview

Pre-built tooling

Pre-built integrations

Access requirements

Setup guide

Useful links

API gotchas

Pre-built tooling

✅ Authorization

Tools	Status
Pre-built authorization (API Key)	✅
Pre-built authorization UI	✅
Custom authorization UI	✅
End-user authorization guide	🚫
Expired credentials detection	✅

✅ Read & write data

Tools	Status
Pre-built integrations	🚫 (time to contribute: <48h)
API unification	✅
2-way sync	✅
Webhooks from Nango on data modifications	✅
Real-time webhooks from 3rd-party API	🚫 (time to contribute: <48h)
Proxy requests	✅

✅ Observability & data quality

Tools	Status
HTTP request logging	✅
End-to-type type safety	✅
Data runtime validation	✅
OpenTelemetry export	✅
Slack alerts on errors	✅
Integration status API	✅

✅ Customization

Tools	Status
Create or customize use-cases	✅
Pre-configured pagination	🚫 (time to contribute: <48h)
Pre-configured rate-limit handling	🚫 (time to contribute: <48h)
Per-customer configurations	✅

No pre-built syncs or actions available yet.

Not seeing the integration you need? Build your own independently.

Access requirements

Pre-Requisites	Status	Comment
Paid dev account	❓
Paid test account	❓
Partnership	❓
App review	❓
Security audit	❓

Setup guide

No setup guide yet.

Need help getting started? Get help in the community.

Contribute improvements to the setup guide by editing this page

Useful links

• How to register an Application
• OAuth-related docs
• Web API docs (their REST API)

Contribute useful links by editing this page

API gotchas

• Personio offers a separate recruiting API that is API key based and is listed under personio-recruiting
• The other API Personio offers is a client credentials token that authorizes as app instead of a user. This is listed under personio.
• (Api V1): The companyId value is required for personio-recruiting and can be retrieved at Settings > Integrations (API Credentials) and clicking on the “Recruiting API Key”. The value for company as required for personio-recruiting is the name you use to login to your account and is the subdomain of your Personio instance.
• (Api V1): The values for partnerId and appId are optional but strongly recommended by Personio. Both can be defined by you, but should represent your company name and application name and MUST follow the UPPER_SNAKE_CASE format. For example MY_APPLICATION, ACME are valid values.

Contribute API gotchas by editing this page

Connect to Personio

Guide to connect to Personio using Nango Connect.