This article gives you an overview of how you can integrate positions from Personio into your company's website via an XML interface we provide. XML stands for eXtensible Markup Language, which provides a computer-readable data structure.
Background for using an XML interface
Personio career pages provide a wide range of design options, but sometimes reach their limit in terms of custom designs and filtering.
You can integrate data via an XML interface to fully implement your individual preferences for your company website, while retaining the ability to control content and the publication status of your positions centrally from within Personio.
Our XML interface allows you to access an XML feed. This XML feed supplies the contents and meta information for all positions you have stored and published in Personio. As the feed is always up to date, any changes you make to a position in Personio are simultaneously transferred to the XML feed.
Publish positions via XML
To publish positions on your website via XML, you need to first activate the XML interface in Personio, and then integrate the XML feed into your website.
Activate XML feed
For the system to create an XML feed, you need to activate it.
- Navigate to Settings > Recruiting > Recruiting.
- In the tab Career page, go to Activations.
- Activate the checkbox Enable XML feed.
- Then click Apply changes in the bottom-right corner.
As soon as you publish a position, it is both output in XML format at youraccount.jobs.personio.de/xml and automatically also made available on the Personio (parent) career page (if activated).
Integrate the XML feed
The integration of positions into your company website via XML feed should be done by an IT expert.
Visit our Developer Hub for detailed documentation of all form items that are output via the XML interface and a practical example for setting up XML integration.
By default, positions in the XML feed are output in German. To access them in English, you need to add the parameter "language" with the value "en": youraccount.jobs.personio.de/xml?language=en.
XML feed content example
The following example shows what the XML feed contains.
> Edit position details.
The XML feed contains the Position ID with all its contents. This information can be found in Recruiting > Positions > Position's title > Description.
The XML feed contains a position's details such as Department, Office, Employment type, etc. This information can be found in Recruiting > Positions > Position's title > Edit position details.
Content and meta information are output as individual items, for example, as the position ID <id>126910</id>. Output data within form items consist of text-only information without any formatting. You can design how the text information will be displayed when you integrate the data into your company website. You can also create forms or filtering options for your candidates to filter positions.
The following image shows the XML feed generated by Personio for the position shown in the screenshots above.
The section About us is not transferred in the XML feed.
If you also want to transfer candidate data from your own system into Personio, you can use Personio's recruiting API. Learn more about this option in our article about Options for Connecting your Career Page to Personio.