Sharing Employee's document with another application

  • 3 June 2024
  • 1 reply


I am working on another application, that wishes to retrieve Personio’s uploaded document. And wish to understand what is the best way to integrate. 

  1. if another application wishes to access Peronio’s one selected employee’s document, what API do I use? 
  2. Am I able to obtain an URL for that Personio document, so that the other application can use that link load that document or do I need to export that Personio Document into my application?
  3. I noticed that there is an API that requires the document_ID, how to I retrieve a selected employee’s document_IDs?  (
  4. If that employee has 3 documents, and i wish to obtain one of the document, based on the category or a key, which API do you suggest?

1 reply

Userlevel 5

Hi @itnewbie,

Every document uploaded to an employee’s profile has a Document ID. You can retrieve this ID by going to the Document section of the employee’s profile and clicking on the document. You will see at the end of the URL “documentId=” followed by a number. This number is the Document ID that you can use for the API. 

Regarding connecting your integration, you can check out the Personio Marketplace to see if you want to use an existing integration or if you wish to connect a Custom integration, please see details in this Help Center article: Build your own integration with our APIs

Thanks for your query and let me know if you have further questions. 😀



Your reply