--- title: Personio slug: personio docTags: rl7p3XLQknqPB1UQ70cu_,pnTugMDqVVXgkHZy0AYvk createdAt: 2025-07-10T11:42:30.304Z --- *** Connect Personio to your Ashby account to automatically import hired candidates to Personio. :::hint{type="warning"} **Permissions & Prerequsites** Users must be an Organizational Admin to set up this integration. ::: # Overview | Sync custom fields | Sync offer letters | Sync file uploads | One or two-way sync | | ------------------ | ------------------ | ----------------- | ----------------------------------- | | ✅ | ✅ | See Notes | One-way sync from Ashby to Personio | # Connecting the integration To configure the integration, you need to configure API credentials in Personio. In Personio: 1. Open **Settings**. 2. Under **Integrations**, choose **API credentials**. 3. Click `Generate new credential`. 4. Name the credential, choose Ashby from the integrations drop-down, and then generate the new credential. 5. Copy your client ID and secret. In Ashby: 1. Navigate to **Admin > Integrations > [Integrations](https://app.ashbyhq.com/admin/integrations/marketplace)**. 2. Search for or find the [Personio tile](https://app.ashbyhq.com/admin/integrations/marketplace/personio) and click on it to open the integration settings. 3. Select the `+ Enable Personio` button. ![Screenshot of the Integrations page showing the "Enable Personio" button. ](https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/3qpSUf5k0DmK9fjAIupAW_personio-ashby-2026-09-10-at-80626-am.jpg) 4. Enter your client ID and secret copied from Personio and click the checkmark. - **Push candidate office and department?: **When enabled, Ashby sends the job’s department and office to Personio. The names must match exactly in both systems, or the candidate push will fail. ![Screenshot of the Personio integration settings in Ashby, showing fields for Client Secret and Client ID, a Test Credentials button, and an option to push candidate office and department data.](https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/SiJsTvDbDXXtGTCj7Hn1B_personio-ashby-2026-09-10-at-81136-am.jpg) ## Syncing documents to Personio You can also set offer letters, resumes, e-signature documents, and other documents to sync over to Personio when candidates are hired and pushed. Once you've added your secret and client ID, select a category using the document category dropdowns. The categories listed are the document categories you have configured in Personio. ![Screenshot of document category dropdowns in the Personio integration settings in Ashby](https://cdn.zappy.app/88f7584255335486d975a898a54cde99.png) Once you've determined your categories, check the boxes beside `Sync offer letters?`, `Sync resumes?`, `Sync e-signatures?`, and/or `Sync other documents?` to enable syncing when you push a candidate to Personio. ![Screenshot of sync checkboxes for offer letters, resumes, e-signatures, and other documents in the Personio integration settings](https://cdn.zappy.app/baaf3fc00da25c4158dea9fefd8efaca.png) Finally, click `Save Document Categories` to confirm your changes. :::hint{type="warning"} If you do not see the option to set categories for documents once you have enabled the integration, check your API key permissions to ensure the key has read/write access. ::: # Data synced to Personio - Email - First Name - Last Name - Position - Hire Date - Department (pulled from the Job's Department/Team) - Office (pulled from the Job's location) - Custom attributes: Ashby generates offer custom fields based on the custom and default attributes from Personio. More on these below. ## Custom attributes :::hint{type="info"} To push custom fields, the API key for the integration must have Employee read/write permissions assigned in Personio. ::: Employee attribute fields from Personio are now pulled into the Personio integration settings within Ashby. Use the `Sync Enabled` toggle beside each attribute to determine which should be synced. If you enable the `Sync Enabled` option, a matching custom field will be created in Ashby that will be linked to the employee attribute field in Personio. ![Screenshot of Personio sync settings showing the Sync Enabled toggle beside each employee attribute](https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/ZH9O13jmUzgGSo7H7fTCg_personio-sync-settings.jpg) If you already have an existing custom field in Ashby, when you switch on the `Sync Enabled` option for the employee attribute, the existing Ashby custom field will be identified, and you have the option to link it to the Personio employee attribute. ::Image[Screenshot showing the option to link an existing Ashby custom field to a Personio employee attribute]{src="https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/5fL0vz7JOQ0zhdbR_gNh__linking-an-existing-custom-field-to-personio.jpg" size="66" width="1210" height="390" position="center" darkWidth="1210" darkHeight="390" showCaption="false" alt="Dialog asking whether to link the City attribute to an existing custom field, with options to cancel or link the custom field."} :::hint{type="info"} If you have used the previous process for mapping employee attributes (that is, creating custom fields manually that match attribute titles in Personio), these will continue to work if you do not opt to use the `Sync Enabled?` toggles. If you do opt to use the toggles to sync over additional information in the future, ensure that the toggles for the original attributes are also enabled and linked to the existing custom fields. ::: Due to Personio API updates, the only preset employee attributes in Personio that can be synced from custom fields in Ashby are: - Department - Position - Office First and last name and email are also synced over by default. Custom attributes created in Personio are supported, so data can be synced from custom fields in Ashby to these custom attributes via the integration. This is a limitation with Personio's API and not a restriction in Ashby, so we recommend reaching out to Personio if you'd like to request expanded API support for additional fields. ### Pre-filling custom attribute fields If you would like to pre-fill these offer fields with information from other custom fields, you can set another field as the default value for the generated offer field. To do this: 1. Navigate to **Admin > Organization Setup > Custom Fields** and go to the **Offer** tab. 2. Click the `Choose a Default Value` dropdown and determine whether you would like to prefill this field with information from another Ashby field or with a static value. ::Image[Screenshot of the Choose a Default Value dropdown in Admin > Organization Setup > Custom Fields on the Offer tab]{src="https://cdn.zappy.app/0e28520fabb1bee8de969f0ee26cf947.png" size="100" isUploading="false" width="594" height="246" darkWidth="594" darkHeight="246" showCaption="false" alt="Default Value dropdown showing options to pre-fill the field from another Ashby field or with a static value." indent="3"} :::hint{type="info"} For more information on custom fields in general, check out [Custom Fields](docId\:QpGKlrSCmzgWC-7krBWDs). Custom fields are not available on the Foundations plan. ::: # Adding new hires to Personio 1. After you've set the **Candidate Offer Response** to Accepted, a new activity titled **Add Candidate to Personio** populates. Click `Add Candidate Data` to start the process of making the candidate available in Personio. 2. Go back to your Personio account and search for the candidate. 3. The new hire data now appears in Personio to complete the onboarding process. ![Screenshot of the Add Candidate to Personio activity in Ashby after an offer response is set to Accepted](https://cdn.zappy.app/e287285535b4653b030d480c12f7fb6c.png) ## Pushing candidate data to Personio automatically :::hint{type="warning"} One candidate needs to have been previously pushed to the system via the manual steps above before this can be enabled. ::: After the offer is accepted and the candidate is marked Hired, data can be sent to Personio via an automatic sync. To enable this: 1. Navigate to **Admin > Integrations > HRIS Integrations**. 2. Check `Automatically push hired candidates to HRIS integrations`. ::Image[Screenshot of Admin > Integrations > HRIS Integrations with the Automatically push hired candidates to HRIS integrations checkbox]{src="https://api.archbee.com/api/optimize/0p8tQ--ZZOxRtkVp6Qr-e/QlP5REGtSnP4bKQP0Ofj4_automatically-push-hired-candidates-to-hris-integrations.jpg" size="100" isUploading="false" width="1898" height="464" darkWidth="1898" darkHeight="464" showCaption="false" alt="HRIS Integrations Settings showing automatic syncing of hired candidate data to enabled HRIS integrations turned on." indent="1"} # Troubleshooting errors when pushing candidates to Personio If Ashby shows a `Failed request to Personio - Something went wrong` error when you select `Add Candidate Data`, your Personio account may have reached its subscription employee limit. Check with your Personio administrator or Personio Support to confirm the limit and increase it if needed. After the limit is addressed, select `Add Candidate Data` again for the same candidate to attempt to export them again.