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
The Personio career page provides a wide range of design options, but sometimes reaches its limits 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 a so-called XML feed. This XML feed supplies the contents and meta information for all positions you have stored in Personio and published. As the feed is always up to date, any changes you make to a position in Personio are simultaneously transferred to the XML feed.
Please note that the XML interface is only available starting with the Professional level plan.
Publishing Positions via XML
Before you can use this function, you need to set up the XML interface correctly, i.e. link the XML feed appropriately to your website.
Integrating positions into your company website via XML feed is best done by an IT expert.
To have the system output job postings in XML format, first activate the XML interface in your account by navigating to Settings > Recruiting > Career page:
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 your Personio career page (if activated).
Personio accounts created on or after November 25, 2020, use the URL youraccount.jobs.personio.de/xml. Click here for more information about this change.
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.
Positions are output in German in the XML feed by default. 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 Examples
The following screenshot shows a section from a position in edit mode. The XML feed shows not only the position ID and contents but also the meta information for the job ad.
Content and meta information are output as individual items, e.g. 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.
The following image shows the XML feed generated by Personio for the position shown in the screenshot above.
Among other things, you can create drop-down form items on your website, which candidate can use to filter positions for various characteristics of the different items. As a result, their experience of finding matching positions will be even more efficient.
The Personio career page, for example, does not allow candidates to filter positions by the required level of experience. However, you can implement this type of filter on your company website by collecting and integrating the corresponding XML element (<seniority>).
Click here to find out more about how to submit applications to the Personio Recruiting module via the Personio Recruiting API.
Can't find what you're looking for?
We are happy to help you! Just write us a message with your questions and we will get back to you as soon as possible.Submit a request