CINXE.COM
Personio Developer Hub
<!DOCTYPE html><html lang="en" style="" data-color-mode="light" class=" useReactApp "><head><meta charset="utf-8"><meta name="readme-deploy" content="5.319.0"><meta name="readme-subdomain" content="personio"><meta name="readme-version" content="2.0"><title>Personio Developer Hub</title><meta name="description"><meta property="og:title" content="Personio Developer Hub"><meta property="og:description"><meta property="og:site_name" content="Personio Developer Hub"><meta name="twitter:title" content="Personio Developer Hub"><meta name="twitter:description"><meta name="twitter:card" content="summary_large_image"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta property="og:image" content="https://files.readme.io/344ccf55e2da6ae08fc012392cc1b7d36c6f8806128c7cbbca6f44ffcc127cac-small-Personio_Wordmark_Black.png"><meta name="twitter:image" content="https://files.readme.io/344ccf55e2da6ae08fc012392cc1b7d36c6f8806128c7cbbca6f44ffcc127cac-small-Personio_Wordmark_Black.png"><link id="favicon" rel="shortcut icon" href="https://files.readme.io/5772748b0e0ebe35eb07b2f3bf4a342b6d4bd44f5f5d692479fffaf1743ccba3-small-VersionBlack_transparent.png" type="image/png"><link rel="canonical" href="https://developer.personio.de/"><script src="https://cdn.readme.io/public/js/cash-dom.min.js?1743615368519"></script><link data-chunk="SuperHub-CustomPage" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/SuperHub-CustomPage.6f815c83f54659ae791f.css"> <link data-chunk="routes-Tutorials" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-Tutorials.7e7736cc7c5b0affc361.css"> <link data-chunk="New" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/New.b2c21b39a87b5c42c152.css"> <link data-chunk="Page" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/Page.b2c21b39a87b5c42c152.css"> <link data-chunk="List" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/List.0b0b64406047e2a3670a.css"> <link data-chunk="routes-Discuss" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-Discuss.b6e3c66bfa4e65097f5f.css"> <link data-chunk="routes-CustomPage" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/CustomPage.38a39d6ce8b0e2afad5a.css"> <link data-chunk="routes-Landing" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-Landing.332d7eed7b2d976c458e.css"> <link data-chunk="routes-SuperHub-Routes" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-SuperHub-Routes.59e02500db2c520b4509.css"> <link data-chunk="routes-Reference" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-Reference.883d037c9b5898d42a5d.css"> <link data-chunk="routes-Changelog" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-Changelog.28957affcff81e852361.css"> <link data-chunk="Editor" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/Editor.23606d783f007047768a.css"> <link data-chunk="routes-Doc" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-Doc.0ab6d6e327e2be33020a.css"> <link data-chunk="Footer" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/Footer.7ca87f1efe735da787ba.css"> <link data-chunk="routes-PageNotFound" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-PageNotFound.d8afd1171cf7a455eed7.css"> <link data-chunk="Header" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/Header.4c8c34bca506869e518a.css"> <link data-chunk="routes-SuperHub" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-SuperHub.7e7ac3b831d39ed8ef99.css"> <link data-chunk="routes-SuperHub" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/7188.75e3fc491ee8103c63a3.css"> <link data-chunk="routes-SuperHub" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/2395.593cd7b6ba0bdb6787a8.css"> <link data-chunk="main" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/main.4c43266695a6f2b7b2bf.css"> <link data-chunk="main" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/ui-styles.63b355d155a153836fc8.css"> <link data-chunk="main" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/main.9223d0842ac0410bafac.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/6601.cef2fa12a9b5e2b9df03.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/1126.9d43ffa1039df16a8271.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/6563.fbd3d15eee3b5e94f665.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/9772.89a3e895d3051e33cd73.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/4904.1067704c85da57778e22.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/7449.dae0332305a8704415a6.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/7372.fbd27ab77e6e47de9931.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/187.23cea47109f7f88417f6.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/734.2949e3d7010fa5c21ffd.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/954.53ce7f86793664155f78.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/1167.a6c63c62c8690225da20.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/2395.771431a607874f268eb2.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/9321.7bab74274e71e18bb347.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/3073.ef6aff2d0ae6023765f1.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/1008.a1d50b1feee374345b35.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/7188.f444adf64944d115c52b.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/5753.72c5d7402efc1cfa5881.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-SuperHub.b9f93ce0513a54980863.js"> <link data-chunk="Header" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/2249.08687f22f6d6de29577d.js"> <link data-chunk="Header" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/3901.9a23139e8c32bd6a1186.js"> <link data-chunk="Header" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/7783.54e7cbd61e710313e1e0.js"> <link data-chunk="Header" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/Header.415a3e3f42422a2546f5.js"> <link data-chunk="routes-PageNotFound" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-PageNotFound.e4a4a4dbb41ce1f8c60f.js"> <link data-chunk="Footer" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/Footer.732d39065ba473dca3be.js"> <link data-chunk="core-icons-chevron-up-down-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-chevron-up-down-svg.6aae957df71e6f4c5e24.js"> <link data-chunk="routes-Doc" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/4287.916cdd386055d2c5d238.js"> <link data-chunk="routes-Doc" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/4201.9726bbf672400e046cc2.js"> <link data-chunk="routes-Doc" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-Doc.ab23d1cf8ea817ed6084.js"> <link data-chunk="core-icons-arrow-right-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-arrow-right-svg.eadb74658f93b4e7d75f.js"> <link data-chunk="Editor" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/Editor.fcff689c44b953a512d6.js"> <link data-chunk="core-icons-x-circle-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-x-circle-svg.abc0e0ea5b7f9dff667c.js"> <link data-chunk="core-icons-suggested-edits-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-suggested-edits-svg.8d2d8ac2fd22ded9238d.js"> <link data-chunk="routes-Changelog" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-Changelog.05be16260f5ffacc35a3.js"> <link data-chunk="Post" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/Post.0ba0ba3778e78d8254e8.js"> <link data-chunk="routes-Reference" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/5948.a51402657e2eb40ab43b.js"> <link data-chunk="routes-Reference" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/8230.6a96ce7f90d7aee9b636.js"> <link data-chunk="routes-Reference" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-Reference.a6b1c6bee69d46fd161f.js"> <link data-chunk="core-icons-alert-circle-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-alert-circle-svg.4cee8264c97045599b56.js"> <link data-chunk="core-icons-more-vertical-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-more-vertical-svg.4822b3f831e11095980d.js"> <link data-chunk="core-icons-lock-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-lock-svg.70942d3ee6bad6267696.js"> <link data-chunk="core-icons-search-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-search-svg.ad9cac962958d30983a7.js"> <link data-chunk="core-icons-custom-pages-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-custom-pages-svg.444e514638d9afbec182.js"> <link data-chunk="core-icons-chevron-down-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-chevron-down-svg.e20b84e9871bd73d1b8c.js"> <link data-chunk="routes-SuperHub-Routes" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/7717.c3f46aef4dac129abcfb.js"> <link data-chunk="routes-SuperHub-Routes" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/5359.fb0c48929b1827a8a2b2.js"> <link data-chunk="routes-SuperHub-Routes" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-SuperHub-Routes.b64fd1d3a15e09bf2b91.js"> <link data-chunk="RMDX" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/RMDX.6966846032c03969e44f.js"> <link data-chunk="routes-Landing" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/3906.b84848dda7e7f59abf47.js"> <link data-chunk="routes-Landing" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-Landing.43a15229736801911d5a.js"> <link data-chunk="routes-CustomPage" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/CustomPage.29543915f3e70fa960d7.js"> <link data-chunk="core-icons-arrow-up-right-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-arrow-up-right-svg.8ec73f7e322d79a2695b.js"> <link data-chunk="routes-Discuss" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-Discuss.9a682a77c9083927aeaf.js"> <link data-chunk="List" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/2637.d47bf77a75f266a70e80.js"> <link data-chunk="List" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/List.b1dd4485529aa4a7aa11.js"> <link data-chunk="core-icons-trending-up-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-trending-up-svg.0dd920b0698e57f75afa.js"> <link data-chunk="core-icons-callout-info-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-callout-info-svg.79b14e8568c9cecbc827.js"> <link data-chunk="Page" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/Page.6d18db72aa3774dd903a.js"> <link data-chunk="core-icons-webhook-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-webhook-svg.fe540ea1c09e1c0e0247.js"> <link data-chunk="New" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/New.19db37c76f3b9d17353d.js"> <link data-chunk="core-icons-message-circle-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-message-circle-svg.1e24c2d2eb4f9a6ede5d.js"> <link data-chunk="core-icons-eye-off-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-eye-off-svg.b2b8b241b4b324dfd9c1.js"> <link data-chunk="core-icons-star-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-star-svg.b834e1612cb2af1e174e.js"> <link data-chunk="routes-Tutorials" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-Tutorials.c83f9bb228d60f5f7f6b.js"> <link data-chunk="SuperHub-CustomPage" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/SuperHub-CustomPage.edef7b501475b233c5a2.js"> <link data-chunk="core-icons-key-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-key-svg.71e09670b926900508b8.js"> <link data-chunk="core-icons-chevron-right-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-chevron-right-svg.34d126524d8ea236d174.js"> <link data-chunk="core-icons-plus-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-plus-svg.a49fb76ac2661b5e1c7e.js"> <link data-chunk="core-icons-folder-plus-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-folder-plus-svg.2c200438e59611867262.js"> <link data-chunk="core-icons-file-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-file-svg.24d3e20044ef331cf0d2.js"> <link data-chunk="core-icons-eye-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-eye-svg.b2103692a3c209893efe.js"> <link data-chunk="core-icons-book-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-book-svg.556c5a2abddd44b2284c.js"> <link data-chunk="core-icons-gauge-circle-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-gauge-circle-svg.fff25782546fef314a09.js"> <link data-chunk="core-icons-code-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-code-svg.d29a4cf99a7105e13528.js"> <link data-chunk="core-icons-upload-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-upload-svg.4d60b51fd8b6157bfc91.js"> <link data-chunk="core-icons-share-2-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-share-2-svg.cc960c8f03a86e1d8def.js"> <link data-chunk="core-icons-edit-2-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-edit-2-svg.a658c6ae7d1bbe84c98a.js"> <link data-chunk="core-icons-inbox-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-inbox-svg.01c2ecb759e417a98bb8.js"> <link data-chunk="core-icons-unlock-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-unlock-svg.d27591cc9e0be731e26d.js"> <link data-chunk="main" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/ui-styles.63b355d155a153836fc8.css"> <link data-chunk="main" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/main.4c43266695a6f2b7b2bf.css"> <link data-chunk="routes-SuperHub" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/2395.593cd7b6ba0bdb6787a8.css"> <link data-chunk="routes-SuperHub" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/7188.75e3fc491ee8103c63a3.css"> <link data-chunk="routes-SuperHub" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-SuperHub.7e7ac3b831d39ed8ef99.css"> <link data-chunk="Header" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/Header.4c8c34bca506869e518a.css"> <link data-chunk="routes-PageNotFound" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-PageNotFound.d8afd1171cf7a455eed7.css"> <link data-chunk="Footer" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/Footer.7ca87f1efe735da787ba.css"> <link data-chunk="routes-Doc" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-Doc.0ab6d6e327e2be33020a.css"> <link data-chunk="Editor" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/Editor.23606d783f007047768a.css"> <link data-chunk="routes-Changelog" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-Changelog.28957affcff81e852361.css"> <link data-chunk="routes-Reference" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-Reference.883d037c9b5898d42a5d.css"> <link data-chunk="routes-SuperHub-Routes" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-SuperHub-Routes.59e02500db2c520b4509.css"> <link data-chunk="routes-Landing" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-Landing.332d7eed7b2d976c458e.css"> <link data-chunk="routes-CustomPage" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/CustomPage.38a39d6ce8b0e2afad5a.css"> <link data-chunk="routes-Discuss" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-Discuss.b6e3c66bfa4e65097f5f.css"> <link data-chunk="List" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/List.0b0b64406047e2a3670a.css"> <link data-chunk="Page" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/Page.b2c21b39a87b5c42c152.css"> <link data-chunk="New" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/New.b2c21b39a87b5c42c152.css"> <link data-chunk="routes-Tutorials" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-Tutorials.7e7736cc7c5b0affc361.css"> <link data-chunk="SuperHub-CustomPage" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/SuperHub-CustomPage.6f815c83f54659ae791f.css"><!-- CUSTOM CSS--><style title="rm-custom-css">:root{--project-color-primary:#000000;--project-color-inverse:#fff;--recipe-button-color:#000000;--recipe-button-color-hover:#000000;--recipe-button-color-active:#000000;--recipe-button-color-focus:rgba(0, 0, 0, 0.25);--recipe-button-color-disabled:#666666}[id=enterprise] .ReadMeUI[is=AlgoliaSearch]{--project-color-primary:#000000;--project-color-inverse:#fff}a{color:var(--color-link-primary,#000)}a:hover{color:var(--color-link-primary-darken-5,#000)}a.text-muted:hover{color:var(--color-link-primary,#000)}.btn.btn-primary{background-color:#000}.btn.btn-primary:hover{background-color:#000}.theme-line #hub-landing-top h2{color:#000}#hub-landing-top .btn:hover{color:#000}.theme-line #hub-landing-top .btn:hover{color:#fff}.theme-solid header#hub-header #header-top{background-color:#000}.theme-solid.header-gradient header#hub-header #header-top{background:linear-gradient(to bottom,#000,#000)}.theme-solid.header-custom header#hub-header #header-top{background-image:url(undefined)}.theme-line header#hub-header #header-top{border-bottom-color:#000}.theme-line header#hub-header #header-top .btn{background-color:#000}header#hub-header #header-top #header-logo{width:211px;height:40px;margin-top:0;background-image:url(https://files.readme.io/344ccf55e2da6ae08fc012392cc1b7d36c6f8806128c7cbbca6f44ffcc127cac-small-Personio_Wordmark_Black.png)}#hub-subheader-parent #hub-subheader .hub-subheader-breadcrumbs .dropdown-menu a:hover{background-color:#000}#subheader-links a.active{color:#000!important;box-shadow:inset 0 -2px 0 #000}#subheader-links a:hover{color:#000!important;box-shadow:inset 0 -2px 0 #000;opacity:.7}.discussion .submit-vote.submit-vote-parent.voted a.submit-vote-button{background-color:#000}section#hub-discuss .discussion a .discuss-body h4{color:#000}section#hub-discuss .discussion a:hover .discuss-body h4{color:#000}#hub-subheader-parent #hub-subheader.sticky-header.sticky{border-bottom-color:#000}#hub-subheader-parent #hub-subheader.sticky-header.sticky .search-box{border-bottom-color:#000}#hub-search-results h3 em{color:#000}.main_background,.tag-item{background:#000!important}.main_background:hover{background:#000!important}.main_color{color:#000!important}.border_bottom_main_color{border-bottom:2px solid #000}.main_color_hover:hover{color:#000!important}section#hub-discuss h1{color:#000}#hub-reference .hub-api .api-definition .api-try-it-out.active{border-color:#000;background-color:#000}#hub-reference .hub-api .api-definition .api-try-it-out.active:hover{background-color:#000;border-color:#000}#hub-reference .hub-api .api-definition .api-try-it-out:hover{border-color:#000;color:#000}#hub-reference .hub-reference .logs .logs-empty .logs-login-button,#hub-reference .hub-reference .logs .logs-login .logs-login-button{background-color:var(--project-color-primary,#000);border-color:var(--project-color-primary,#000)}#hub-reference .hub-reference .logs .logs-empty .logs-login-button:hover,#hub-reference .hub-reference .logs .logs-login .logs-login-button:hover{background-color:#000;border-color:#000}#hub-reference .hub-reference .logs .logs-empty>svg>path,#hub-reference .hub-reference .logs .logs-login>svg>path{fill:#000;fill:var(--project-color-primary,#000)}#hub-reference .hub-reference .logs:last-child .logs-empty,#hub-reference .hub-reference .logs:last-child .logs-login{margin-bottom:35px}#hub-reference .hub-reference .hub-reference-section .hub-reference-left header .hub-reference-edit:hover{color:#000}.main-color-accent{border-bottom:3px solid #000;padding-bottom:8px}/*! BEGIN HUB_CUSTOM_STYLES */.hub-reference-left>div.magic-block-callout,.hub-reference-left>div.magic-block-textarea{margin-top:30px}body{font-family:Inter,-apple-system,system-ui,BlinkMacSystemFont,"Segoe UI",Roboto,"Helvetica Neue",Arial,sans-serif!important}a{color:#000;font-weight:600}img.rm-Logo-img{height:0;width:0;padding:0 189px 23px 0;background-image:url(https://files.readme.io/4842909267541fef0dcce0fe79f121a83b9f318f80a9c08a788cac044b7c1f69-dev_hub_white_pr.png);background-size:cover}header.rm-Header{position:sticky;top:0;box-shadow:none;-webkit-box-shadow:none}.Header-topuTMpygDG4e1V .rm-SearchToggle-icon,div.rm-Header-left button.icon-menu,div.rm-Header-left div{color:#fff!important}div.rm-Header-top{border:none;background:#000}div.rm-Header-top a.Button{color:#fff}div.rm-Header-top a.Button:active,div.rm-Header-top a.Button:hover{color:#fff!important;text-decoration:underline}div.rm-Header-bottom{border:none;background-color:#fff}@media only screen and (max-width:768px){a.Button.rm-Header-top-link{display:none}}a.Button.rm-Header-bottom-link{color:#000!important;font-weight:400}a.Button.rm-Header-bottom-link.active{background:0 0;border-bottom:2px solid #000;font-weight:600}#main-landing-section{margin:15px 0}#main-landing-section mark{border-radius:23px;background:#ff0;padding:1px 6px}.btn.btn-primary{background-color:#0db5df!important}.btn.btn-secondary{background-color:#f4f7f9!important;color:#555!important}h2.heading{font-family:InterVariable,Open Sans,Helvetica Neue,Helvetica,Arial,sans-serif;font-size:24px;font-weight:700;line-height:32px;color:#2d3747}h3.heading{font-family:InterVariable,Open Sans,Helvetica Neue,Helvetica,Arial,sans-serif;font-size:18px;font-weight:700;line-height:24px;color:#2d3747}*{box-sizing:border-box}.column{float:left;width:50%;padding:0 30px}.row-card{margin:0 -30px}@media screen and (max-width:600px){.column{width:100%;display:block;margin-bottom:20px}}.card{box-shadow:0 13px 13px 0 rgba(0,0,0,.04);padding:35px;text-align:left;background:#fff;border-radius:8px;border:1px solid #dce6ec}.card h2{font-size:22px;margin:0;margin-top:0!important}.card p{font-size:16px;line-height:24px}.card a{margin:0}nav#hub-sidebar ul a.active,nav#hub-sidebar ul>li.subnav-expanded>a{color:#555;background-color:#cff0f9;font-weight:500}.callout.callout_info{border-left:3px solid #0b98bb;border-radius:4px}.hub-changelog-list .changelog-post h3{font-family:InterVariable,Open Sans,Helvetica Neue,Helvetica,Arial,sans-serif;font-size:18px;font-weight:700;line-height:24px;color:#2d3747}#changelog-type-icon.cl-improved,.icon-changelog-type.cl-improved{background-color:#0db5df}#readmeLogo{display:none}/*! END HUB_CUSTOM_STYLES */</style><meta name="loadedProject" content="personio"><script>var storedColorMode = `light` === 'system' ? window.localStorage.getItem('color-scheme') : `light` document.querySelector('[data-color-mode]').setAttribute('data-color-mode', storedColorMode)</script><script id="config" type="application/json" data-json="{"algoliaIndex":"readme_search_v2","amplitude":{"apiKey":"dc8065a65ef83d6ad23e37aaf014fc84","enabled":true},"asset_url":"https://cdn.readme.io","domain":"readme.io","domainFull":"https://dash.readme.com","encryptedLocalStorageKey":"ekfls-2025-03-27","fullstory":{"enabled":true,"orgId":"FSV9A"},"metrics":{"billingCronEnabled":"true","dashUrl":"https://m.readme.io","defaultUrl":"https://m.readme.io","exportMaxRetries":12,"wsUrl":"wss://m.readme.io"},"proxyUrl":"https://try.readme.io","readmeRecaptchaSiteKey":"6LesVBYpAAAAAESOCHOyo2kF9SZXPVb54Nwf3i2x","releaseVersion":"5.319.0","sentry":{"dsn":"https://3bbe57a973254129bcb93e47dc0cc46f@o343074.ingest.sentry.io/2052166","enabled":true,"tracesSampleRate":0},"shMigration":{"promoVideo":"","forceWaitlist":false},"sslBaseDomain":"readmessl.com","sslGenerationService":"ssl.readmessl.com","stripePk":"pk_live_5103PML2qXbDukVh7GDAkQoR4NSuLqy8idd5xtdm9407XdPR6o3bo663C1ruEGhXJjpnb2YCpj8EU1UvQYanuCjtr00t1DRCf2a","superHub":{"newProjectsEnabled":true},"wootric":{"accountToken":"NPS-122b75a4","enabled":true}}"></script></head><body class="body-none theme-line header-solid header-bg-size-auto header-bg-pos-tl header-overlay-triangles reference-layout-column lumosity-dark no-sidebar hub-is-home"><div id="ssr-top"></div><div id="ssr-main"><div class="App ThemeContext ThemeContext_dark ThemeContext_line" style="--color-primary:#000000;--color-primary-inverse:#fff;--color-primary-alt:#000000;--color-primary-darken-10:#000000;--color-primary-darken-20:#000000;--color-primary-alpha-25:rgba(0, 0, 0, 0.25);--color-link-primary:#000000;--color-link-primary-darken-5:#000000;--color-link-primary-darken-10:#000000;--color-link-primary-darken-20:#000000;--color-link-primary-alpha-50:rgba(0, 0, 0, 0.5);--color-link-primary-alpha-25:rgba(0, 0, 0, 0.25);--color-link-background:rgba(0, 0, 0, 0.09);--color-link-text:#fff;--color-login-link:#018ef5;--color-login-link-text:#fff;--color-login-link-darken-10:#0171c2;--color-login-link-primary-alpha-50:rgba(1, 142, 245, 0.5)"><header class="Header3zzata9F_ZPQ rm-Header "><div class="rm-Header-top Header-topuTMpygDG4e1V"><div class="rm-Container rm-Container_flex"><div style="outline:none" tabindex="-1"><a href="#content" target="_self" class="Button Button_md rm-JumpTo Header-jumpTo3IWKQXmhSI5D Button_primary">Jump to Content</a></div><div class="rm-Header-left Header-leftADQdGVqx1wqU"><a class="rm-Logo Header-logo1Xy41PtkzbdG" href="/" target="_self"><img alt="Personio Developer Hub" class="rm-Logo-img Header-logo-img3YvV4lcGKkeb" src="https://files.readme.io/344ccf55e2da6ae08fc012392cc1b7d36c6f8806128c7cbbca6f44ffcc127cac-small-Personio_Wordmark_Black.png"/></a></div><div class="rm-Header-left Header-leftADQdGVqx1wqU Header-left_mobile1RG-X93lx6PF"><div><button aria-label="Toggle navigation menu" class="icon-menu menu3d6DYNDa3tk5" type="button"></button><div class=""><div class="Flyout95xhYIIoTKtc undefined rm-Flyout" data-testid="flyout"><div class="MobileFlyout1hHJpUd-nYkd"><a aria-current="page" class="rm-MobileFlyout-item NavItem-item1gDDTqaXGhm1 NavItem-item_mobile1qG3gd-Mkck- active" href="/" target="_self"><i class="icon-landing-page-2 NavItem-badge1qOxpfTiALoz"></i><span class="NavItem-textSlZuuL489uiw">Home</span></a><a class="rm-MobileFlyout-item NavItem-item1gDDTqaXGhm1 NavItem-item_mobile1qG3gd-Mkck- " href="/docs" target="_self"><i class="icon-guides NavItem-badge1qOxpfTiALoz"></i><span class="NavItem-textSlZuuL489uiw">Documentation</span></a><a class="rm-MobileFlyout-item NavItem-item1gDDTqaXGhm1 NavItem-item_mobile1qG3gd-Mkck- " href="/reference" target="_self"><i class="icon-references NavItem-badge1qOxpfTiALoz"></i><span class="NavItem-textSlZuuL489uiw">API Reference</span></a><a class="rm-MobileFlyout-item NavItem-item1gDDTqaXGhm1 NavItem-item_mobile1qG3gd-Mkck- " href="/changelog" target="_self"><i class="icon-changelog NavItem-badge1qOxpfTiALoz"></i><span class="NavItem-textSlZuuL489uiw">Changelog</span></a><a class="rm-MobileFlyout-item NavItem-item1gDDTqaXGhm1 NavItem-item_mobile1qG3gd-Mkck- " href="/discuss" target="_self"><i class="icon-discussions NavItem-badge1qOxpfTiALoz"></i><span class="NavItem-textSlZuuL489uiw">Discussions</span></a><select class="Select Select_md NavItem-item1gDDTqaXGhm1 NavItem-item_select3UEfLN-oSjxp NavItem-item_mobile1qG3gd-Mkck-"><option data-url="/v1.0/" value="1.0">v1.0</option><option selected="" data-url="#" value="2.0">v2.0</option></select><hr class="MobileFlyout-divider10xf7R2X1MeW"/><a class="rm-MobileFlyout-item NavItem-item1gDDTqaXGhm1 NavItem-item_mobile1qG3gd-Mkck- NavItem_dropdown-muted1xJVuczwGc74" href="https://www.personio.com/partner/tech/" rel="noopener" target="_blank" to="https://www.personio.com/partner/tech/">Become a Partner</a><a class="MobileFlyout-logo3Lq1eTlk1K76 Header-logo1Xy41PtkzbdG rm-Logo" href="/" target="_self"><img alt="Personio Developer Hub" class="Header-logo-img3YvV4lcGKkeb rm-Logo-img" src="https://files.readme.io/344ccf55e2da6ae08fc012392cc1b7d36c6f8806128c7cbbca6f44ffcc127cac-small-Personio_Wordmark_Black.png"/></a></div></div></div></div><div class="Header-left-nav2xWPWMNHOGf_"><i class="icon-landing-page-2 Header-left-nav-icon10glJKFwewOv"></i>Home</div></div><div class="rm-Header-right Header-right21PC2XTT6aMg"><span class="Header-right_desktop14ja01RUQ7HE"><a class="Button Button_md rm-Header-link rm-Header-top-link Button_slate_text Header-link2tXYTgXq85zW" href="https://www.personio.com/partner/tech/" target="_self" to="https://www.personio.com/partner/tech/">Become a Partner</a></span><div class="Header-searchtb6Foi0-D9Vx"><button aria-label="Search ⌘k" class="rm-SearchToggle" data-symbol="⌘"><div class="rm-SearchToggle-icon icon-search1"></div></button></div></div></div><div class="undefined container"><div></div></div></div><div class="Header-bottom2eLKOFXMEmh5 rm-Header-bottom "><div class="rm-Container rm-Container_flex"><nav aria-label="Primary navigation" class="Header-leftADQdGVqx1wqU" role="navigation"><div class="rm-VersionDropdown Dropdown Dropdown_closed"><button aria-haspopup="dialog" class="Button Button_slate_text Button_md rm-Header-bottom-link Dropdown-toggle Button_primary" type="button"><span class="Truncate1OzxBYrNNfH3" style="--Truncate-max-width:150px">v2.0</span><i class="icon icon-chevron-down"></i></button></div><a aria-current="page" class="Button Button_md rm-Header-link rm-Header-bottom-link Button_slate_text Header-bottom-link_mobile active" href="/" target="_self"><i class="icon-landing-page-2"></i><span>Home</span></a><a class="Button Button_md rm-Header-link rm-Header-bottom-link Button_slate_text Header-bottom-link_mobile " href="/docs" target="_self"><i class="icon-guides"></i><span>Documentation</span></a><a class="Button Button_md rm-Header-link rm-Header-bottom-link Button_slate_text Header-bottom-link_mobile " href="/reference" target="_self"><i class="icon-references"></i><span>API Reference</span></a><a class="Button Button_md rm-Header-link rm-Header-bottom-link Button_slate_text Header-bottom-link_mobile " href="/changelog" target="_self"><i class="icon-changelog"></i><span>Changelog</span></a><a class="Button Button_md rm-Header-link rm-Header-bottom-link Button_slate_text Header-bottom-link_mobile " href="/discuss" target="_self"><i class="icon-discussions"></i><span>Discussions</span></a></nav><div class="rm-Header-search Header-searchtb6Foi0-D9Vx rm-Header-search_feather Header-search_featherYsmQBn55F3d9"><button aria-label="Search ⌘k" class="rm-SearchToggle" data-symbol="⌘"><div class="rm-SearchToggle-icon icon-search1"></div><div class="Header-search-placeholder3Vx4OmMPcjAi rm-SearchToggle-placeholder">Search</div><div class="rm-SearchToggle-shortcut"></div></button></div></div></div><div class="hub-search-results--reactApp " id="hub-search-results"><div class="hub-container"><div class="modal-backdrop show-modal rm-SearchModal" role="button" tabindex="0"></div></div></div></header><main class="LandingWrap16kRMSdr5J8g rm-LandingPage" id="content"><div class="rm-Markdown markdown-body LandingBlock3PM-HyBxby3X LandingBlock_align=leftG1r7ROyW_AGB" data-testid="RDMD"><div class="rdmd-html"><section style=" max-width: 768px; margin: 0 auto; display: flex; flex-direction: column; align-items: center;"> <div style="font-size:46px; font-weight: 800; text-align:center;line-height:1;">Build better organizations,<br/> one line of code at a time</div> <div style="max-width: 60ch; margin: 48px auto 12px"> <p style="margin: 0 0 32px 0;"> Seamlessly integrate Personio with your existing tools and workflows using our powerful APIs, and build automations, scripts, and applications that <mark style="background-color: #FFFCCC; font-weight: 600;">supercharge</mark> your HR processes. </p> <p style="display: flex; flex-grow: 0; "> <a href="/docs?ref=intro" style=" margin-right: 10px; display: flex; align-items: center; padding: 10px 18px 10px 20px; border-radius: 40px; border: 1px solid black; background: black; color: white; text-decoration: none; "> <svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" style="height: 14px; width: 14px; margin-right: 8px; "> <path stroke-linecap="round" stroke-linejoin="round" d="M15.59 14.37a6 6 0 0 1-5.84 7.38v-4.8m5.84-2.58a14.98 14.98 0 0 0 6.16-12.12A14.98 14.98 0 0 0 9.631 8.41m5.96 5.96a14.926 14.926 0 0 1-5.841 2.58m-.119-8.54a6 6 0 0 0-7.381 5.84h4.8m2.581-5.84a14.927 14.927 0 0 0-2.58 5.84m2.699 2.7c-.103.021-.207.041-.311.06a15.09 15.09 0 0 1-2.448-2.448 14.9 14.9 0 0 1 .06-.312m-2.24 2.39a4.493 4.493 0 0 0-1.757 4.306 4.493 4.493 0 0 0 4.306-1.758M16.5 9a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0Z" /> </svg> Get Started </a> <a href="/reference?ref=intro" style=" display: flex; align-items: center; padding: 10px 20px; border-radius: 40px; color: black; border: 1px solid black; text-decoration: none; "> <svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" style="height: 14px; width: 14px; margin-right: 8px; "> <path stroke-linecap="round" stroke-linejoin="round" d="M12 6.042A8.967 8.967 0 0 0 6 3.75c-1.052 0-2.062.18-3 .512v14.25A8.987 8.987 0 0 1 6 18c2.305 0 4.408.867 6 2.292m0-14.25a8.966 8.966 0 0 1 6-2.292c1.052 0 2.062.18 3 .512v14.25A8.987 8.987 0 0 0 18 18a8.967 8.967 0 0 0-6 2.292m0-14.25v14.25" /> </svg> API Reference</a> </p> <div style="background: #EAE5FF; margin-top: 48px; padding: 24px"> <p style="font-size: 20px; margin: 0 0 9px 0; font-weight: 700">Partners & publishers</p> <p style="margin: 0 0 9px 0;"> Join Personio’s marketplace and empower 10,000+ businesses with your innovative solutions. </p> <p style="margin:0"> <a style="color: black; font-weight: 700; text-decoration: none;" href="https://support.personio.de/hc/en-us/articles/360011430518-First-Steps-Towards-a-Product-Partnership-With-Personio?ref=dev_hero"> <span style="text-decoration: underline;">Become a product partner</span> <svg xmlns="http://www.w3.org/2000/svg" fill="none" viewBox="0 0 24 24" stroke-width="1.5" stroke="currentColor" style="width: 12px; height: 12px;"> <path stroke-linecap="round" stroke-linejoin="round" d="M13.5 6H5.25A2.25 2.25 0 0 0 3 8.25v10.5A2.25 2.25 0 0 0 5.25 21h10.5A2.25 2.25 0 0 0 18 18.75V10.5m-10.5 6L21 3m0 0h-5.25M21 3v5.25" /> </svg> </a> </p> </div> </section> <!-- <div id="main-landing-section"> <div id="hub-landing-top" class="hub-landing-buttons"> <div class="container"> <div class="row" style='display: flex;'> <div class="col-12 col-md-5 col-lg-5 col-xl-5"> <h2>Let’s enable better organizations – <mark>together.</mark></h2> <div class="hub-landing-description"> <p> Whether you want to build an out-of-the-box integration for Personio's 8000+ customers or just for your own team, these resources will help you get started. </p> </div> <a href="/docs" ui-sref="docs" class="btn btn-lg btn-primary" data-ol-has-click-handler=""><i class="fa fa-rocket"></i>Get Started </a> <a href="/reference" ui-sref="reference" class="btn btn-lg btn-secondary" data-ol-has-click-handler=""><i class="icon icon-reference-2"></i><span>API Reference</span> </a> </div> <div class="col-12 col-md-7 col-lg-7 col-xl-7"> <!-- <img src="https://www.personio.de/wp-content/uploads/2019/12/Integrationen-1024x571.png"> --> <!-- </div> </div> </div> </div> </div> --></div></div><div class="rm-Markdown markdown-body LandingBlock3PM-HyBxby3X LandingBlock_align=leftG1r7ROyW_AGB" data-testid="RDMD"><div class="rdmd-html"><!-- <div class='row-card'> <div class='column'> <div class="card"> <h2>For partners</h2> <p> Integrate with Personio and display your app to 8000+ small and medium-sized businesses. </p> <a href="https://support.personio.de/hc/en-us/articles/360011430518-First-Steps-Towards-a-Product-Partnership-With-Personio">Become a product partner</a> </div> </div> <div class='column'> <div class="card"> <h2>For customers</h2> <p>Automate people workflows by connecting your IT landscape to the single source of truth for employee data.</p> <a href="https://developer.personio.de/docs/getting-started-with-the-personio-api">Get started with the API</a> </div> </div> </div> --></div></div><div class="LandingBlock3PM-HyBxby3X LandingBlock_align=center12RqtJarcIcH"><div class="rm-Markdown markdown-body" data-testid="RDMD"><h2 class="heading heading-2 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="personio-webhooks-are-now-live"></div><div class="heading-text"><div id="section-personio-webhooks-are-now-live" class="heading-anchor_backwardsCompatibility"></div>Personio Webhooks are now live!</div><a aria-label="Skip link to Personio Webhooks are now live!" class="heading-anchor-icon fa fa-anchor" href="#personio-webhooks-are-now-live"></a></h2> <p>We are proud to announce that Webhooks for the Person entity are now available to all Personio customers who have access to the Public API. To get started on your Webhooks journey, please navigate to <a target="_self" href="/reference/webhooks">https://developer.personio.de/v2.0/reference/webhooks</a></p></div></div></main><footer aria-label="Status banner" class="Footer2U8XAPoGhlgO AppFooter rm-Banners"></footer><div class="ModalWrapper" id="ChatGPT-modal"></div></div></div><div class="ng-non-bindable"><script id="ssr-props" data-initial-props="{"sidebars":{"docs":[{"_id":"6527bc3eb308ad001a4f2578","project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","isAPI":false,"reference":false,"createdAt":"2019-05-28T07:38:55.311Z","order":0,"slug":"getting-started","title":"Getting started","__v":0,"pages":[{"_id":"6527bc3eb308ad001a4f2595","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[],"examples":{"codes":[]}},"title":"Get started with Personio API","type":"basic","slug":"getting-started-with-the-personio-api","order":0,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","createdAt":"2020-08-20T08:57:44.027Z","category":"6527bc3eb308ad001a4f2578","parentDoc":null,"deprecated":false,"icon":"","mdx":{},"isBodyEmpty":false,"children":[{"_id":"6527bc3eb308ad001a4f259e","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[],"examples":{"codes":[]}},"title":"Marketplace TOS & API Policy","type":"basic","slug":"tos-api-security-1","order":0,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","createdAt":"2021-10-08T07:17:52.185Z","parentDoc":"6527bc3eb308ad001a4f2595","category":"6527bc3eb308ad001a4f2578","icon":"","isBodyEmpty":false,"children":[]}]},{"_id":"6527bc3eb308ad001a4f25b6","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[],"examples":{"codes":[]}},"title":"For product partners","icon":"","type":"basic","slug":"ipaas-partner","order":999,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","category":"6527bc3eb308ad001a4f2578","createdAt":"2023-01-27T16:06:57.607Z","mdx":{},"isBodyEmpty":false,"children":[]}]},{"_id":"6527bc3eb308ad001a4f2574","version":"6527bc3eb308ad001a4f25c0","from_sync":false,"isAPI":false,"reference":false,"slug":"documentation","__v":0,"createdAt":"2017-03-07T14:51:33.011Z","order":3,"project":"58bec8f49d43720f0043fdb2","title":"Recruiting","pages":[{"_id":"6527bc3eb308ad001a4f257f","category":"6527bc3eb308ad001a4f2574","slug":"retrieving-open-job-positions","link_external":false,"link_url":"","title":"Retrieving open positions","type":"basic","isReference":false,"parentDoc":null,"order":0,"sync_unique":"","api":{"params":[],"url":"","method":"get","results":{"codes":[{"language":"json","code":"{}","name":"","status":200},{"status":400,"language":"json","code":"{}","name":""}]},"auth":"required"},"createdAt":"2017-03-24T12:00:34.319Z","hidden":false,"previousSlug":"","deprecated":false,"icon":"","isBodyEmpty":false,"children":[{"_id":"6527bc3eb308ad001a4f2581","createdAt":"2017-03-24T12:13:15.655Z","hidden":false,"sync_unique":"","parentDoc":"6527bc3eb308ad001a4f257f","type":"basic","category":"6527bc3eb308ad001a4f2574","order":0,"slug":"integration-via-iframe","title":"Integration via Iframe","api":{"auth":"required","params":[],"url":"","method":"get","results":{"codes":[{"code":"{}","name":"","status":200,"language":"json"},{"name":"","status":400,"language":"json","code":"{}"}]}},"isReference":false,"link_external":false,"link_url":"","previousSlug":"","deprecated":false,"icon":"","isBodyEmpty":false,"children":[]},{"_id":"6527bc3eb308ad001a4f2580","link_url":"","api":{"url":"","method":"get","results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"auth":"required","params":[]},"hidden":false,"isReference":false,"title":"Integration via code","category":"6527bc3eb308ad001a4f2574","slug":"integration-of-open-positions","createdAt":"2017-03-24T12:05:37.669Z","order":1,"sync_unique":"","link_external":false,"parentDoc":"6527bc3eb308ad001a4f257f","type":"basic","previousSlug":"","deprecated":false,"icon":"","isBodyEmpty":false,"children":[]}]},{"_id":"6527bc3eb308ad001a4f257d","parentDoc":null,"slug":"applications-endpoint","order":1,"title":"Passing applications to Personio","link_url":"","link_external":false,"sync_unique":"","api":{"auth":"required","method":"get","params":[],"results":{"codes":[{"language":"json","code":"{}","name":"","status":200},{"status":400,"language":"json","code":"{}","name":""}]},"url":""},"hidden":false,"category":"6527bc3eb308ad001a4f2574","createdAt":"2017-03-07T14:51:33.051Z","isReference":false,"type":"basic","previousSlug":"","deprecated":false,"icon":"","mdx":{},"isBodyEmpty":false,"children":[]}]},{"_id":"66d1a4bad7abe20018cfe6dc","title":"Shift Planning Integration Guide","slug":"shift-planning-integration-guide","order":9999,"reference":false,"project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","createdAt":"2024-08-30T10:53:46.508Z","__v":0,"pages":[{"_id":"66d1aa600d08830052a3f260","api":{"method":"get","url":"","auth":"required","params":[]},"title":"Key points for Implementing Shift Planning Integration with Personio HRIS","icon":"","type":"basic","slug":"key-points-for-implementing-shift-planning-integration-with-personio-hris","order":999,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","category":"66d1a4bad7abe20018cfe6dc","createdAt":"2024-08-30T11:17:52.018Z","isBodyEmpty":false,"children":[]},{"_id":"66d1ab0b5f5a870012b2b896","api":{"method":"get","url":"","auth":"required","params":[]},"title":"Introduction and Prerequisites","icon":"","type":"basic","slug":"introduction-and-prerequisites","order":999,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","category":"66d1a4bad7abe20018cfe6dc","createdAt":"2024-08-30T11:20:43.127Z","isBodyEmpty":false,"children":[]},{"_id":"66d1b115700490004b9e01ac","api":{"method":"get","url":"","auth":"required","params":[]},"title":"Initial core data sync","icon":"","type":"basic","slug":"initial-core-data-sync","order":999,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","category":"66d1a4bad7abe20018cfe6dc","createdAt":"2024-08-30T11:46:29.115Z","isBodyEmpty":false,"children":[]},{"_id":"66d1b21e834b25000f5935ed","api":{"method":"get","url":"","auth":"required","params":[]},"title":"Event-driven data from Personio","icon":"","type":"basic","slug":"event-driven-data-from-personio","order":999,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","category":"66d1a4bad7abe20018cfe6dc","createdAt":"2024-08-30T11:50:54.975Z","isBodyEmpty":false,"children":[{"_id":"66d822efef9868003667ef38","api":{"method":"get","url":"","auth":"required","params":[]},"title":"Attendance & Absence Events","icon":"","type":"basic","slug":"attendance-and-absence-events","order":999,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"person-and-employment-updates","parentDoc":"66d1b21e834b25000f5935ed","category":"66d1a4bad7abe20018cfe6dc","createdAt":"2024-09-04T09:05:51.828Z","isBodyEmpty":false,"children":[]},{"_id":"66d824c555113b004a63dceb","api":{"method":"get","url":"","auth":"required","params":[]},"title":"Handling Logic for Shift Planning","icon":"","type":"basic","slug":"handling-logic","order":999,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","parentDoc":"66d1b21e834b25000f5935ed","category":"66d1a4bad7abe20018cfe6dc","createdAt":"2024-09-04T09:13:41.400Z","isBodyEmpty":false,"children":[]}]},{"_id":"66d82d1dd668c9003c82d996","api":{"method":"get","url":"","auth":"required","params":[]},"title":"Guidelines on when not to update Personio","icon":"","type":"basic","slug":"guidelines-on-when-not-to-update-personio","order":999,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","category":"66d1a4bad7abe20018cfe6dc","createdAt":"2024-09-04T09:49:17.146Z","isBodyEmpty":false,"children":[]},{"_id":"66d82e55d7f631002059e968","api":{"method":"get","url":"","auth":"required","params":[]},"title":"Guidelines for syncing information into Personio","icon":"","type":"basic","slug":"guidelines-for-syncing-information-into-personio","order":999,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","category":"66d1a4bad7abe20018cfe6dc","createdAt":"2024-09-04T09:54:29.143Z","mdx":{},"isBodyEmpty":false,"children":[]}]}],"refs":[{"_id":"6527bc3eb308ad001a4f2576","createdAt":"2017-03-19T14:34:54.117Z","from_sync":false,"order":1,"title":"Overview","__v":0,"project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","slug":"overview","isAPI":false,"reference":true,"pages":[{"_id":"6527bc3eb308ad001a4f257e","type":"basic","category":"6527bc3eb308ad001a4f2576","link_url":"","sync_unique":"","title":"Introduction","createdAt":"2017-03-19T14:40:54.670Z","parentDoc":null,"slug":"introduction","isReference":true,"api":{"method":"get","results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"auth":"required","params":[],"url":"","examples":{"codes":[]}},"hidden":false,"link_external":false,"order":0,"deprecated":false,"previousSlug":"","icon":"","isBodyEmpty":false,"children":[]},{"_id":"6527bc3eb308ad001a4f25a8","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[],"examples":{"codes":[]}},"title":"Include our headers in your requests","type":"basic","slug":"include-our-headers-in-your-requests","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","createdAt":"2022-01-20T11:02:09.287Z","category":"6527bc3eb308ad001a4f2576","parentDoc":null,"icon":"","isBodyEmpty":false,"children":[]}]},{"_id":"6527d2b80618570039103154","title":"Authentication","slug":"authentication","order":2,"reference":true,"project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","createdAt":"2023-10-12T11:04:24.130Z","__v":0,"pages":[{"_id":"655f5292a78ced0047e54ab2","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"6527d2b80618570039103152"},"title":"Authentication","icon":"","type":"basic","slug":"authentication","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Authentication","link_url":"","link_external":false,"previousSlug":"","category":"6527d2b80618570039103154","createdAt":"2023-11-23T13:24:34.274Z","parentDoc":null,"isBodyEmpty":false,"children":[{"_id":"6527d2b9061857003910315d","api":{"method":"post","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"6527d2b80618570039103152"},"title":"Obtain Access Token","icon":"","type":"endpoint","slug":"post_v2-auth-token","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"post_v2-auth-token","link_url":"","link_external":false,"previousSlug":"","category":"6527d2b80618570039103154","createdAt":"2023-10-12T11:04:25.487Z","parentDoc":"655f5292a78ced0047e54ab2","isBodyEmpty":true,"children":[]},{"_id":"66977fc8f3c8ae00450b6082","api":{"method":"post","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"6527d2b80618570039103152"},"title":"Revoke Access Token","icon":"","type":"endpoint","slug":"post_v2-auth-revoke","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"post_v2-auth-revoke","link_url":"","link_external":false,"previousSlug":"","category":"6527d2b80618570039103154","createdAt":"2024-07-17T08:24:40.631Z","parentDoc":"655f5292a78ced0047e54ab2","isBodyEmpty":true,"children":[]}]}]},{"_id":"655cb153e417660068aeead2","title":"Webhooks Management API","slug":"webhooks-management-api","order":3,"reference":true,"project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","createdAt":"2023-11-21T13:32:03.788Z","__v":0,"pages":[{"_id":"6613c2e073f13200184b44f7","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"655cb153e417660068aeead0"},"title":"Webhooks","icon":"","type":"basic","slug":"webhooks","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Webhooks","link_url":"","link_external":false,"previousSlug":"webhooks-1","category":"655cb153e417660068aeead2","createdAt":"2024-04-08T10:11:44.073Z","parentDoc":null,"mdx":{},"isBodyEmpty":false,"children":[{"_id":"655cb157e417660068aeead5","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"655cb153e417660068aeead0"},"title":"List webhooks.","icon":"","type":"endpoint","slug":"get_v2-webhooks","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-webhooks","link_url":"","link_external":false,"previousSlug":"","category":"655cb153e417660068aeead2","createdAt":"2023-11-21T13:32:07.582Z","parentDoc":"6613c2e073f13200184b44f7","mdx":{},"isBodyEmpty":true,"children":[]},{"_id":"655cb157e417660068aeead6","api":{"method":"post","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"655cb153e417660068aeead0"},"title":"Create new webhook.","icon":"","type":"endpoint","slug":"post_v2-webhooks","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"post_v2-webhooks","link_url":"","link_external":false,"previousSlug":"","category":"655cb153e417660068aeead2","createdAt":"2023-11-21T13:32:07.589Z","parentDoc":"6613c2e073f13200184b44f7","mdx":{},"isBodyEmpty":true,"children":[]},{"_id":"65e86a5628aa640020d6ae86","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"655cb153e417660068aeead0"},"title":"Get a webhook.","icon":"","type":"endpoint","slug":"get_v2-webhooks-id","order":2,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-webhooks-id","link_url":"","link_external":false,"previousSlug":"","category":"655cb153e417660068aeead2","createdAt":"2024-03-06T13:06:30.167Z","parentDoc":"6613c2e073f13200184b44f7","mdx":{},"isBodyEmpty":true,"children":[]},{"_id":"655cb157e417660068aeead7","api":{"method":"patch","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"655cb153e417660068aeead0"},"title":"Update a webhook.","icon":"","type":"endpoint","slug":"patch_v2-webhooks-id","order":3,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"patch_v2-webhooks-id","link_url":"","link_external":false,"previousSlug":"","category":"655cb153e417660068aeead2","createdAt":"2023-11-21T13:32:07.591Z","parentDoc":"6613c2e073f13200184b44f7","mdx":{},"isBodyEmpty":true,"children":[]},{"_id":"655cb157e417660068aeead8","api":{"method":"delete","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"655cb153e417660068aeead0"},"title":"Delete a webhook.","icon":"","type":"endpoint","slug":"delete_v2-webhooks-id","order":4,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"delete_v2-webhooks-id","link_url":"","link_external":false,"previousSlug":"","category":"655cb153e417660068aeead2","createdAt":"2023-11-21T13:32:07.594Z","parentDoc":"6613c2e073f13200184b44f7","mdx":{},"isBodyEmpty":true,"children":[]},{"_id":"669a2487cb2d0c00690c9fe8","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"655cb153e417660068aeead0"},"title":"Get webhook delivery activity","icon":"","type":"endpoint","slug":"get_v2-webhooks-id-activity","order":5,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-webhooks-id-activity","link_url":"","link_external":false,"previousSlug":"","category":"655cb153e417660068aeead2","createdAt":"2024-07-19T08:32:07.706Z","parentDoc":"6613c2e073f13200184b44f7","mdx":{},"isBodyEmpty":true,"children":[]},{"_id":"6761558554c60e001ee7b49c","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"655cb153e417660068aeead0"},"title":"Get webhook events","icon":"","type":"endpoint","slug":"get_v2-webhooks-id-events","order":6,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-webhooks-id-events","link_url":"","link_external":false,"previousSlug":"","category":"655cb153e417660068aeead2","createdAt":"2024-12-17T10:42:13.849Z","parentDoc":"6613c2e073f13200184b44f7","isBodyEmpty":true,"children":[]}]}]},{"_id":"65fc0bc31513cc001c8c83c5","title":"Document Management","slug":"document-management","order":5,"reference":true,"project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","createdAt":"2024-03-21T10:28:19.545Z","__v":0,"pages":[{"_id":"65fc0bc41513cc001c8c83c6","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"65fc0bc31513cc001c8c83c3"},"title":"Document Management","icon":"","type":"basic","slug":"document-management","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Document Management","link_url":"","link_external":false,"previousSlug":"","category":"65fc0bc31513cc001c8c83c5","createdAt":"2024-03-21T10:28:20.402Z","parentDoc":null,"mdx":{},"isBodyEmpty":false,"children":[{"_id":"65fc0bc41513cc001c8c83c8","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"65fc0bc31513cc001c8c83c3"},"title":"List document metadata.","icon":"","type":"endpoint","slug":"get_v2-document-management-documents","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-document-management-documents","link_url":"","link_external":false,"previousSlug":"","category":"65fc0bc31513cc001c8c83c5","createdAt":"2024-03-21T10:28:20.482Z","parentDoc":"65fc0bc41513cc001c8c83c6","isBodyEmpty":true,"children":[]},{"_id":"65fc0bc41513cc001c8c83c9","api":{"method":"patch","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"65fc0bc31513cc001c8c83c3"},"title":"Update document metadata.","icon":"","type":"endpoint","slug":"patch_v2-document-management-documents-document-id","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"patch_v2-document-management-documents-document-id","link_url":"","link_external":false,"previousSlug":"","category":"65fc0bc31513cc001c8c83c5","createdAt":"2024-03-21T10:28:20.483Z","parentDoc":"65fc0bc41513cc001c8c83c6","isBodyEmpty":true,"children":[]},{"_id":"65fc0bc41513cc001c8c83ca","api":{"method":"delete","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"65fc0bc31513cc001c8c83c3"},"title":"Delete document.","icon":"","type":"endpoint","slug":"delete_v2-document-management-documents-document-id","order":2,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"delete_v2-document-management-documents-document-id","link_url":"","link_external":false,"previousSlug":"","category":"65fc0bc31513cc001c8c83c5","createdAt":"2024-03-21T10:28:20.483Z","parentDoc":"65fc0bc41513cc001c8c83c6","isBodyEmpty":true,"children":[]},{"_id":"65fc0bc41513cc001c8c83cb","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"65fc0bc31513cc001c8c83c3"},"title":"Download document file.","icon":"","type":"endpoint","slug":"get_v2-document-management-documents-document-id-download","order":3,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-document-management-documents-document-id-download","link_url":"","link_external":false,"previousSlug":"","category":"65fc0bc31513cc001c8c83c5","createdAt":"2024-03-21T10:28:20.484Z","parentDoc":"65fc0bc41513cc001c8c83c6","isBodyEmpty":true,"children":[]}]}]},{"_id":"66215d6ad2bf100019706d80","title":"Person","slug":"person-3","order":6,"reference":true,"project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","createdAt":"2024-04-18T17:50:34.867Z","__v":0,"pages":[{"_id":"662f75edaa8116005aac11bd","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"66215d6ad2bf100019706d7e"},"title":"Persons","icon":"","type":"basic","slug":"persons-closed-alpha","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Persons (Closed Alpha)","link_url":"","link_external":false,"previousSlug":"","category":"66215d6ad2bf100019706d80","createdAt":"2024-04-29T10:26:53.641Z","parentDoc":null,"isBodyEmpty":false,"children":[{"_id":"66215d6bd2bf100019706d83","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66215d6ad2bf100019706d7e"},"title":"List persons.","icon":"","type":"endpoint","slug":"get_v2-persons","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-persons","link_url":"","link_external":false,"previousSlug":"","category":"66215d6ad2bf100019706d80","createdAt":"2024-04-18T17:50:35.987Z","parentDoc":"662f75edaa8116005aac11bd","isBodyEmpty":true,"children":[]},{"_id":"66a2407e1b5fa0004ac4d90a","api":{"method":"post","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66a2407d1b5fa0004ac4d903"},"title":"Create a new Person and Employment.","icon":"","type":"endpoint","slug":"post_v2-persons","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"post_v2-persons","link_url":"","link_external":false,"previousSlug":"","category":"66215d6ad2bf100019706d80","createdAt":"2024-07-25T12:09:34.600Z","parentDoc":"662f75edaa8116005aac11bd","isBodyEmpty":true,"children":[]},{"_id":"66215d6bd2bf100019706d84","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66215d6ad2bf100019706d7e"},"title":"Retrieve a person.","icon":"","type":"endpoint","slug":"get_v2-persons-id","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-persons-id","link_url":"","link_external":false,"previousSlug":"","category":"66215d6ad2bf100019706d80","createdAt":"2024-04-18T17:50:35.988Z","parentDoc":"662f75edaa8116005aac11bd","isBodyEmpty":true,"children":[]},{"_id":"66a2407e1b5fa0004ac4d90b","api":{"method":"patch","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66a2407d1b5fa0004ac4d903"},"title":"Update a Person.","icon":"","type":"endpoint","slug":"patch_v2-persons-person-id","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"patch_v2-persons-person-id","link_url":"","link_external":false,"previousSlug":"","category":"66215d6ad2bf100019706d80","createdAt":"2024-07-25T12:09:34.602Z","parentDoc":"662f75edaa8116005aac11bd","isBodyEmpty":true,"children":[]},{"_id":"66a2407e1b5fa0004ac4d90c","api":{"method":"delete","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66a2407d1b5fa0004ac4d903"},"title":"Delete a Person.","icon":"","type":"endpoint","slug":"delete_v2-persons-person-id","order":2,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"delete_v2-persons-person-id","link_url":"","link_external":false,"previousSlug":"","category":"66215d6ad2bf100019706d80","createdAt":"2024-07-25T12:09:34.602Z","parentDoc":"662f75edaa8116005aac11bd","isBodyEmpty":true,"children":[]}]}]},{"_id":"66215d6939b32f001096f59f","title":"Employment","slug":"employment-4","order":7,"reference":true,"project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","createdAt":"2024-04-18T17:50:33.167Z","__v":0,"pages":[{"_id":"662f75f0d0f6a000192a4893","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"66215d6939b32f001096f59d"},"title":"Employment","icon":"","type":"basic","slug":"employment-closed-alpha","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Employment (Closed Alpha)","link_url":"","link_external":false,"previousSlug":"","category":"66215d6939b32f001096f59f","createdAt":"2024-04-29T10:26:56.532Z","parentDoc":null,"isBodyEmpty":false,"children":[{"_id":"66215d6939b32f001096f5a2","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66215d6939b32f001096f59d"},"title":"List employments of a given Person.","icon":"","type":"endpoint","slug":"get_v2-persons-person-id-employments","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-persons-person-id-employments","link_url":"","link_external":false,"previousSlug":"","category":"66215d6939b32f001096f59f","createdAt":"2024-04-18T17:50:33.998Z","parentDoc":"662f75f0d0f6a000192a4893","isBodyEmpty":true,"children":[]},{"_id":"66a2407e1b5fa0004ac4d90d","api":{"method":"patch","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66a2407d1b5fa0004ac4d903"},"title":"Update an Employment.","icon":"","type":"endpoint","slug":"patch_v2-persons-person-id-employments-employment-id","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"patch_v2-persons-person-id-employments-employment-id","link_url":"","link_external":false,"previousSlug":"","category":"66215d6939b32f001096f59f","createdAt":"2024-07-25T12:09:34.603Z","parentDoc":"662f75f0d0f6a000192a4893","isBodyEmpty":true,"children":[]},{"_id":"66215d6939b32f001096f5a3","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66215d6939b32f001096f59d"},"title":"Retrieve an employment.","icon":"","type":"endpoint","slug":"get_v2-persons-person-id-employments-id","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-persons-person-id-employments-id","link_url":"","link_external":false,"previousSlug":"","category":"66215d6939b32f001096f59f","createdAt":"2024-04-18T17:50:33.999Z","parentDoc":"662f75f0d0f6a000192a4893","isBodyEmpty":true,"children":[]}]}]},{"_id":"663341c29091f700423214af","title":"Payroll Integrations API","slug":"payroll-integrations-api","order":8,"reference":true,"project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","createdAt":"2024-05-02T07:33:22.692Z","__v":0,"pages":[{"_id":"663341c39091f700423214b0","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"663341c29091f700423214ad"},"title":"Compensations","icon":"","type":"basic","slug":"compensations-1","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Compensations","link_url":"","link_external":false,"previousSlug":"","category":"663341c29091f700423214af","createdAt":"2024-05-02T07:33:23.420Z","parentDoc":null,"mdx":{},"isBodyEmpty":true,"children":[{"_id":"663341c2e0cd1e005c14bf90","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"663341c1e0cd1e005c14bf8b"},"title":"List Compensation Types","icon":"","type":"endpoint","slug":"get_v2-compensations-types","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-compensations-types","link_url":"","link_external":false,"previousSlug":"","category":"663341c29091f700423214af","createdAt":"2024-05-02T07:33:22.162Z","parentDoc":"663341c39091f700423214b0","isBodyEmpty":true,"children":[]},{"_id":"66339bf9c69bfa004b65f9ce","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"663341c29091f700423214ad"},"title":"List compensations.","icon":"","type":"endpoint","slug":"get_v2-compensations","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-compensations","link_url":"","link_external":false,"previousSlug":"","category":"663341c29091f700423214af","createdAt":"2024-05-02T13:58:17.383Z","parentDoc":"663341c39091f700423214b0","mdx":{},"isBodyEmpty":true,"children":[]},{"_id":"66339bf9c69bfa004b65f9cf","api":{"method":"post","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"663341c29091f700423214ad"},"title":"Create Compensation.","icon":"","type":"endpoint","slug":"post_v2-compensations","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"post_v2-compensations","link_url":"","link_external":false,"previousSlug":"","category":"663341c29091f700423214af","createdAt":"2024-05-02T13:58:17.384Z","parentDoc":"663341c39091f700423214b0","mdx":{},"isBodyEmpty":true,"children":[]},{"_id":"663341c2e0cd1e005c14bf91","api":{"method":"post","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"663341c1e0cd1e005c14bf8b"},"title":"Create Compensation Types","icon":"","type":"endpoint","slug":"post_v2-compensations-types","order":2,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"post_v2-compensations-types","link_url":"","link_external":false,"previousSlug":"","category":"663341c29091f700423214af","createdAt":"2024-05-02T07:33:22.163Z","parentDoc":"663341c39091f700423214b0","isBodyEmpty":true,"children":[]}]}]},{"_id":"664c75e859e7480036248e1a","title":"Organization Management","slug":"organization-management","order":9,"reference":true,"project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","createdAt":"2024-05-21T10:22:32.672Z","__v":0,"pages":[{"_id":"66a11afd486de70025987739","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"664c75e859e7480036248e18"},"title":"Org Units","icon":"","type":"basic","slug":"org-units","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Org Units","link_url":"","link_external":false,"previousSlug":"","category":"664c75e859e7480036248e1a","createdAt":"2024-07-24T15:17:17.465Z","parentDoc":null,"isBodyEmpty":true,"children":[{"_id":"66a11afd486de7002598773b","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"664c75e859e7480036248e18"},"title":"Retrieves an Org Unit.","icon":"","type":"endpoint","slug":"getorgunit-1","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"getOrgUnit","link_url":"","link_external":false,"previousSlug":"","category":"664c75e859e7480036248e1a","createdAt":"2024-07-24T15:17:17.491Z","parentDoc":"66a11afd486de70025987739","isBodyEmpty":true,"children":[]}]}]},{"_id":"66a11ab16c0a50006290acb4","title":"Legal Entities","slug":"legal-entities","order":10,"reference":true,"project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","createdAt":"2024-07-24T15:16:01.320Z","__v":0,"pages":[{"_id":"66a11ab26c0a50006290acb5","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"66a11ab16c0a50006290acb2"},"title":"Legal Entities","icon":"","type":"basic","slug":"legal-entities-1","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Legal Entities","link_url":"","link_external":false,"previousSlug":"","category":"66a11ab16c0a50006290acb4","createdAt":"2024-07-24T15:16:02.552Z","parentDoc":null,"isBodyEmpty":true,"children":[{"_id":"66a11ab26c0a50006290acb7","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66a11ab16c0a50006290acb2"},"title":"List legal entities.","icon":"","type":"endpoint","slug":"listlegalentities-1","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"listLegalEntities","link_url":"","link_external":false,"previousSlug":"","category":"66a11ab16c0a50006290acb4","createdAt":"2024-07-24T15:16:02.574Z","parentDoc":"66a11ab26c0a50006290acb5","isBodyEmpty":true,"children":[]},{"_id":"66a11ab26c0a50006290acb8","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66a11ab16c0a50006290acb2"},"title":"Retrieves a legal entity.","icon":"","type":"endpoint","slug":"getlegalentitybyid-1","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"getLegalEntityById","link_url":"","link_external":false,"previousSlug":"","category":"66a11ab16c0a50006290acb4","createdAt":"2024-07-24T15:16:02.574Z","parentDoc":"66a11ab26c0a50006290acb5","isBodyEmpty":true,"children":[]}]}]},{"_id":"66d9b8948761d7005adb7554","title":"Absence Period API","slug":"absence-period-api","order":13,"reference":true,"project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","createdAt":"2024-09-05T13:56:36.869Z","__v":0,"pages":[{"_id":"66d9b8958761d7005adb7555","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"66d9b8948761d7005adb7552"},"title":"Absence Periods","icon":"","type":"basic","slug":"absence-periods-closed-alpha","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Absence Periods (Closed Alpha)","link_url":"","link_external":false,"previousSlug":"","category":"66d9b8948761d7005adb7554","createdAt":"2024-09-05T13:56:37.792Z","mdx":{},"isBodyEmpty":true,"children":[{"_id":"66d9b8958761d7005adb755b","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66d9b8948761d7005adb7552"},"title":"Retrieves an absence period by ID.","icon":"","type":"endpoint","slug":"get_v2-absence-periods-id","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-absence-periods-id","link_url":"","link_external":false,"previousSlug":"","category":"66d9b8948761d7005adb7554","createdAt":"2024-09-05T13:56:37.855Z","parentDoc":"66d9b8958761d7005adb7555","isBodyEmpty":true,"children":[]},{"_id":"66d9b8958761d7005adb755c","api":{"method":"delete","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66d9b8948761d7005adb7552"},"title":"Deletes an absence period by ID.","icon":"","type":"endpoint","slug":"delete_v2-absence-periods-id","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"delete_v2-absence-periods-id","link_url":"","link_external":false,"previousSlug":"","category":"66d9b8948761d7005adb7554","createdAt":"2024-09-05T13:56:37.856Z","parentDoc":"66d9b8958761d7005adb7555","isBodyEmpty":true,"children":[]},{"_id":"66d9b8958761d7005adb755d","api":{"method":"patch","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66d9b8948761d7005adb7552"},"title":"Updates an absence period by ID.","icon":"","type":"endpoint","slug":"patch_v2-absence-periods-id","order":2,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"patch_v2-absence-periods-id","link_url":"","link_external":false,"previousSlug":"","category":"66d9b8948761d7005adb7554","createdAt":"2024-09-05T13:56:37.856Z","parentDoc":"66d9b8958761d7005adb7555","isBodyEmpty":true,"children":[]},{"_id":"66d9b8958761d7005adb755f","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66d9b8948761d7005adb7552"},"title":"List absence periods.","icon":"","type":"endpoint","slug":"get_v2-absence-periods","order":3,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-absence-periods","link_url":"","link_external":false,"previousSlug":"","category":"66d9b8948761d7005adb7554","createdAt":"2024-09-05T13:56:37.857Z","parentDoc":"66d9b8958761d7005adb7555","isBodyEmpty":true,"children":[]},{"_id":"66d9b8958761d7005adb7560","api":{"method":"post","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66d9b8948761d7005adb7552"},"title":"Creates a new absence period.","icon":"","type":"endpoint","slug":"post_v2-absence-periods","order":4,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"post_v2-absence-periods","link_url":"","link_external":false,"previousSlug":"","category":"66d9b8948761d7005adb7554","createdAt":"2024-09-05T13:56:37.857Z","parentDoc":"66d9b8958761d7005adb7555","isBodyEmpty":true,"children":[]}]},{"_id":"66d9b8958761d7005adb7556","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"66d9b8948761d7005adb7552"},"title":"Absence Periods Breakdowns","icon":"","type":"basic","slug":"absence-periods-breakdowns-closed-alpha","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Absence Periods Breakdowns (Closed Alpha)","link_url":"","link_external":false,"previousSlug":"","category":"66d9b8948761d7005adb7554","createdAt":"2024-09-05T13:56:37.793Z","mdx":{},"isBodyEmpty":true,"children":[{"_id":"66d9b8958761d7005adb755e","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66d9b8948761d7005adb7552"},"title":"Retrieves daily absence period breakdowns for a given absence period.","icon":"","type":"endpoint","slug":"get_v2-absence-periods-id-breakdowns","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-absence-periods-id-breakdowns","link_url":"","link_external":false,"previousSlug":"","category":"66d9b8948761d7005adb7554","createdAt":"2024-09-05T13:56:37.856Z","parentDoc":"66d9b8958761d7005adb7556","isBodyEmpty":true,"children":[]}]},{"_id":"66d9b8958761d7005adb7557","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"66d9b8948761d7005adb7552"},"title":"Absence Types","icon":"","type":"basic","slug":"absence-types-closed-alpha","order":2,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Absence Types (Closed Alpha)","link_url":"","link_external":false,"previousSlug":"","category":"66d9b8948761d7005adb7554","createdAt":"2024-09-05T13:56:37.793Z","mdx":{},"isBodyEmpty":true,"children":[{"_id":"66d9b8958761d7005adb7561","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66d9b8948761d7005adb7552"},"title":"Retrieves an absence type by ID.","icon":"","type":"endpoint","slug":"get_v2-absence-types-id","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-absence-types-id","link_url":"","link_external":false,"previousSlug":"","category":"66d9b8948761d7005adb7554","createdAt":"2024-09-05T13:56:37.857Z","parentDoc":"66d9b8958761d7005adb7557","isBodyEmpty":true,"children":[]},{"_id":"66d9b8958761d7005adb7562","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66d9b8948761d7005adb7552"},"title":"List absence types.","icon":"","type":"endpoint","slug":"get_v2-absence-types","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-absence-types","link_url":"","link_external":false,"previousSlug":"","category":"66d9b8948761d7005adb7554","createdAt":"2024-09-05T13:56:37.858Z","parentDoc":"66d9b8958761d7005adb7557","isBodyEmpty":true,"children":[]}]}]},{"_id":"66d9b820191cd8005b8ba713","title":"Attendances API","slug":"attendances-api","order":14,"reference":true,"project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","createdAt":"2024-09-05T13:54:40.538Z","__v":0,"pages":[{"_id":"66d9b821191cd8005b8ba714","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"66d9b820191cd8005b8ba711"},"title":"Attendances","icon":"","type":"basic","slug":"attendances-closed-alpha","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Attendances (Closed Alpha)","link_url":"","link_external":false,"previousSlug":"","category":"66d9b820191cd8005b8ba713","createdAt":"2024-09-05T13:54:41.473Z","mdx":{},"isBodyEmpty":true,"children":[{"_id":"66d9b821191cd8005b8ba716","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66d9b820191cd8005b8ba711"},"title":"Get an attendance period.","icon":"","type":"endpoint","slug":"get_v2-attendance-periods-id","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-attendance-periods-id","link_url":"","link_external":false,"previousSlug":"","category":"66d9b820191cd8005b8ba713","createdAt":"2024-09-05T13:54:41.500Z","parentDoc":"66d9b821191cd8005b8ba714","isBodyEmpty":true,"children":[]},{"_id":"66d9b821191cd8005b8ba717","api":{"method":"delete","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66d9b820191cd8005b8ba711"},"title":"Delete an attendance period by ID.","icon":"","type":"endpoint","slug":"delete_v2-attendance-periods-id","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"delete_v2-attendance-periods-id","link_url":"","link_external":false,"previousSlug":"","category":"66d9b820191cd8005b8ba713","createdAt":"2024-09-05T13:54:41.501Z","parentDoc":"66d9b821191cd8005b8ba714","isBodyEmpty":true,"children":[]},{"_id":"66d9b821191cd8005b8ba718","api":{"method":"patch","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66d9b820191cd8005b8ba711"},"title":"Update an attendance period.","icon":"","type":"endpoint","slug":"patch_v2-attendance-periods-id","order":2,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"patch_v2-attendance-periods-id","link_url":"","link_external":false,"previousSlug":"","category":"66d9b820191cd8005b8ba713","createdAt":"2024-09-05T13:54:41.502Z","parentDoc":"66d9b821191cd8005b8ba714","isBodyEmpty":true,"children":[]},{"_id":"66d9b821191cd8005b8ba719","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66d9b820191cd8005b8ba711"},"title":"List attendance periods.","icon":"","type":"endpoint","slug":"get_v2-attendance-periods","order":3,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-attendance-periods","link_url":"","link_external":false,"previousSlug":"","category":"66d9b820191cd8005b8ba713","createdAt":"2024-09-05T13:54:41.502Z","parentDoc":"66d9b821191cd8005b8ba714","isBodyEmpty":true,"children":[]},{"_id":"66d9b821191cd8005b8ba71a","api":{"method":"post","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66d9b820191cd8005b8ba711"},"title":"Create an attendance period.","icon":"","type":"endpoint","slug":"post_v2-attendance-periods","order":4,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"post_v2-attendance-periods","link_url":"","link_external":false,"previousSlug":"","category":"66d9b820191cd8005b8ba713","createdAt":"2024-09-05T13:54:41.503Z","parentDoc":"66d9b821191cd8005b8ba714","isBodyEmpty":true,"children":[]}]}]},{"_id":"67c9be266828a10044ed87f9","title":"Recruiting (Beta)","slug":"recruiting-beta","order":9999,"reference":true,"project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","createdAt":"2025-03-06T15:24:22.948Z","__v":0,"pages":[{"_id":"67cabcdb7ee9220031862853","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"67c9be266828a10044ed87f7"},"title":"Applications","icon":"","type":"basic","slug":"applications","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Applications","link_url":"","link_external":false,"previousSlug":"","category":"67c9be266828a10044ed87f9","createdAt":"2025-03-07T09:31:07.384Z","isBodyEmpty":true,"children":[{"_id":"67cabcdb7ee9220031862855","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"67c9be266828a10044ed87f7"},"title":"List all applications.","icon":"","type":"endpoint","slug":"get_v2-recruiting-applications","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-recruiting-applications","link_url":"","link_external":false,"previousSlug":"","category":"67c9be266828a10044ed87f9","createdAt":"2025-03-07T09:31:07.412Z","parentDoc":"67cabcdb7ee9220031862853","isBodyEmpty":true,"children":[]},{"_id":"67cabcdb7ee9220031862856","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"67c9be266828a10044ed87f7"},"title":"Retrieve an application by ID.","icon":"","type":"endpoint","slug":"get_v2-recruiting-applications-id","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-recruiting-applications-id","link_url":"","link_external":false,"previousSlug":"","category":"67c9be266828a10044ed87f9","createdAt":"2025-03-07T09:31:07.413Z","parentDoc":"67cabcdb7ee9220031862853","isBodyEmpty":true,"children":[]},{"_id":"67cabcdb7ee9220031862857","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"67c9be266828a10044ed87f7"},"title":"List all application stage transitions for an application ID.","icon":"","type":"endpoint","slug":"get_v2-recruiting-applications-id-stage-transitions","order":2,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-recruiting-applications-id-stage-transitions","link_url":"","link_external":false,"previousSlug":"","category":"67c9be266828a10044ed87f9","createdAt":"2025-03-07T09:31:07.413Z","parentDoc":"67cabcdb7ee9220031862853","isBodyEmpty":true,"children":[]}]},{"_id":"67cace481b74c900454b2a99","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"67c9be266828a10044ed87f7"},"title":"Candidates","icon":"","type":"basic","slug":"candidates","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Candidates","link_url":"","link_external":false,"previousSlug":"","category":"67c9be266828a10044ed87f9","createdAt":"2025-03-07T10:45:28.854Z","isBodyEmpty":true,"children":[{"_id":"67cace481b74c900454b2a9d","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"67c9be266828a10044ed87f7"},"title":"List all candidates.","icon":"","type":"endpoint","slug":"get_v2-recruiting-candidates-1","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-recruiting-candidates","link_url":"","link_external":false,"previousSlug":"","category":"67c9be266828a10044ed87f9","createdAt":"2025-03-07T10:45:28.925Z","parentDoc":"67cace481b74c900454b2a99","isBodyEmpty":true,"children":[]},{"_id":"67cace481b74c900454b2a9e","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"67c9be266828a10044ed87f7"},"title":"Retrieve a candidate by ID.","icon":"","type":"endpoint","slug":"get_v2-recruiting-candidates-id-1","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-recruiting-candidates-id","link_url":"","link_external":false,"previousSlug":"","category":"67c9be266828a10044ed87f9","createdAt":"2025-03-07T10:45:28.926Z","parentDoc":"67cace481b74c900454b2a99","isBodyEmpty":true,"children":[]}]},{"_id":"67cace481b74c900454b2a9a","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"67c9be266828a10044ed87f7"},"title":"Jobs","icon":"","type":"basic","slug":"jobs","order":2,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Jobs","link_url":"","link_external":false,"previousSlug":"","category":"67c9be266828a10044ed87f9","createdAt":"2025-03-07T10:45:28.855Z","isBodyEmpty":true,"children":[{"_id":"67cace481b74c900454b2a9f","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"67c9be266828a10044ed87f7"},"title":"List all jobs.","icon":"","type":"endpoint","slug":"get_v2-recruiting-jobs","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-recruiting-jobs","link_url":"","link_external":false,"previousSlug":"","category":"67c9be266828a10044ed87f9","createdAt":"2025-03-07T10:45:28.926Z","parentDoc":"67cace481b74c900454b2a9a","isBodyEmpty":true,"children":[]},{"_id":"67cace481b74c900454b2aa0","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"67c9be266828a10044ed87f7"},"title":"Retrieve an job by ID.","icon":"","type":"endpoint","slug":"get_v2-recruiting-jobs-id","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-recruiting-jobs-id","link_url":"","link_external":false,"previousSlug":"","category":"67c9be266828a10044ed87f9","createdAt":"2025-03-07T10:45:28.927Z","parentDoc":"67cace481b74c900454b2a9a","isBodyEmpty":true,"children":[]}]},{"_id":"67e572b6b7fc80002ac5f9f5","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"67c9be266828a10044ed87f7"},"title":"Categories","icon":"","type":"basic","slug":"categories","order":3,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Categories","link_url":"","link_external":false,"previousSlug":"","category":"67c9be266828a10044ed87f9","createdAt":"2025-03-27T15:45:58.172Z","isBodyEmpty":true,"children":[{"_id":"67e572b6b7fc80002ac5f9f7","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"67c9be266828a10044ed87f7"},"title":"List all job categories.","icon":"","type":"endpoint","slug":"get_v2-recruiting-categories","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-recruiting-categories","link_url":"","link_external":false,"previousSlug":"","category":"67c9be266828a10044ed87f9","createdAt":"2025-03-27T15:45:58.269Z","parentDoc":"67e572b6b7fc80002ac5f9f5","isBodyEmpty":true,"children":[]},{"_id":"67e572b6b7fc80002ac5f9f8","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"67c9be266828a10044ed87f7"},"title":"Retrieve a job category by its ID.","icon":"","type":"endpoint","slug":"get_v2-recruiting-categories-id","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-recruiting-categories-id","link_url":"","link_external":false,"previousSlug":"","category":"67c9be266828a10044ed87f9","createdAt":"2025-03-27T15:45:58.269Z","parentDoc":"67e572b6b7fc80002ac5f9f5","isBodyEmpty":true,"children":[]}]}]}]},"apiBaseUrl":"/","baseUrl":"/","search":{"appId":"T28YKFATPY","searchApiKey":"NTVhM2ExMjA5MjZlMzk1ZThjYTkzZmQzMjEyZmFlNGNlM2Q0OGM0OTBhYjE1NTMxYmM1NTA3ZTZjMmFkZGFkNHRhZ0ZpbHRlcnM9KHByb2plY3Q6NThiZWM4ZjQ5ZDQzNzIwZjAwNDNmZGIyKSwodmVyc2lvbjpub25lLHZlcnNpb246NjUyN2JjM2ViMzA4YWQwMDFhNGYyNWMwKSwoaGlkZGVuOm5vbmUsaGlkZGVuOmZhbHNlKSwoaW5kZXg6Q3VzdG9tUGFnZSxpbmRleDpQYWdlLGluZGV4OkRpc2N1c3MsaW5kZXg6QmxvZyk=","indexName":"readme_search_v2","projectsMeta":[{"modules":{"docs":true,"landing":true,"suggested_edits":false,"discuss":true,"reference":true,"examples":true,"changelog":true,"custompages":false,"logs":false,"tutorials":false,"graphql":false},"id":"58bec8f49d43720f0043fdb2","name":"Personio Developer Hub","subdomain":"personio","subpath":"","nav_names":{"discuss":"","docs":"Documentation","reference":"API Reference","changelog":"","tutorials":"","recipes":""}}],"UrlManager":{"options":{"child":false,"parent":null,"hasOneChild":false,"project":null,"version":null,"lang":"en"},"defaults":{"lang":"en"}},"urlManagerOpts":{"lang":"en","parent":{"childrenProjects":[]},"project":{"subdomain":"personio"},"version":"2.0"}},"changelogs":[{"metadata":{"image":[],"title":"","description":"","keywords":""},"mdx":{"altBody":"","status":"rdmd"},"algolia":{"recordCount":1,"publishPending":false,"updatedAt":"2025-02-05T09:01:13.997Z"},"title":"Important Update – Migration to Personio’s .com Domain","slug":"important-update-migration-to-personios-com-domain","body":"**What’s Changing?** \nPersonio is migrating its primary web domains from **.de** to **.com** to support global expansion.\n\n**Web Access**\n\n- Customers accessing _<customer-name>.personio.de_ will be automatically redirected to _<customer-name>.app.personio.com_.\n- New customers will use _<company-name>.app.personio.com_ directly.\n\n**Emails**\n\n- Most emails from Personio will now come from [\\_@personio.com\\_](mailto:_@personio.com_) instead of [\\_@personio.de\\_](mailto:_@personio.de_).\n\n**What You Need to Do**\n\n- Inform your IT teams to\n - add _<companyname>.app.personio.com_ to your allowlist for web access.\n - add [\\_@personio.com\\_](mailto:_@personio.com_) to your email safelist to avoid spam filtering.\n\n> 📘 There are no changes to the Public API, which remains under _.de_. There will be no impact to existing integrations.\n\n**Timeline** \nMigration will occur between March 10 – March 31. We’ll provide updates to ensure a smooth transition.\n\n**FAQ** \n**Will this impact my data storage?** \nNo, there is no impact on data storage policies or customer data. \nAll data residency requirements remain unchanged.\n\n**Will this affect the Public Api or Integrations?** \nThere are no changes and the Public API will remain on .de. \nThere will be no impact to your existing integrations.\n\n**For Customers using Personio Recruiting, will this change my career page domain or email address that I currently use for recruiting?** \nNo, this change does not impact your career page domain or your recruiting email address. Your current career page URL will continue to work and you will still be able to send emails as before.","searchContents":"","type":"","hidden":false,"revision":5,"_id":"67a20b2c566db20012f7dafb","user":{"name":"Public API Support","_id":"63c82a048cc78b035a7896c0"},"project":"58bec8f49d43720f0043fdb2","createdAt":"2025-02-04T12:42:20.037Z","updatedAt":"2025-02-05T09:01:13.487Z","lastUpdatedHash":"4f2768bf957b6ce0aca787845123102ee5dabcd9","__v":0},{"metadata":{"image":[],"title":"","description":"","keywords":""},"mdx":{"altBody":"","status":"rdmd"},"algolia":{"recordCount":1,"publishPending":false,"updatedAt":"2025-01-24T09:23:59.923Z"},"title":"Absence Period Creation Update","slug":"absence-period-creation-update","body":"As of 24th January 2025, a critical update has been made to the absence period creation process in the API to address an issue with single-day requests involving half-day settings. This update ensures that invalid absence period requests are properly handled to prevent unintended balance accounting issues.\n\n> When creating an absence period for a single day with both `half_day_start` and `half_day_end`set to `true`, the system previously allowed the creation of an absence. This was likely not the intended behaviour for most users, who might have meant to create a full-day absence.\n\n**Resolution:** The API now prevents the creation of single-day absence periods where both `half_day_start` and `half_day_end` are set to `true`. Attempts to create such absences will now result in an error response as below.\n\n```\n\"code\":400,\"message\":\"Invalid absence day. Reason: Both half day start and half day end are true for a single-day period\"\n```\n\n**Error Handling:**\n\nTo create a full-day absence, ensure that both `half_day_start` and `half_day_end` are set to `false`. Refer to the updated format specifications below for valid absence period configurations.\n\nPAPI **v1** Absence Period Time Range Fields (Daily Absences Types)\n\n[block:image]\n{\n \"images\": [\n {\n \"image\": [\n \"https://files.readme.io/a2d46d34561cf6a7fdb752586ddc685845000396846e7e7d4aac711faf9c92d9-Screenshot_2025-01-13_at_10.40.33.png\",\n \"\",\n \"\"\n ],\n \"align\": \"center\"\n }\n ]\n}\n[/block]","searchContents":"","type":"improved","hidden":false,"revision":17,"_id":"6784dff3afe2110048d156ee","user":{"name":"Public API Support","_id":"63c82a048cc78b035a7896c0"},"project":"58bec8f49d43720f0043fdb2","createdAt":"2025-01-13T09:42:11.995Z","updatedAt":"2025-01-24T09:23:58.273Z","lastUpdatedHash":"cd76b1f263a5a72927875d29c88c60357bafef1c","__v":0},{"metadata":{"image":[],"title":"","description":"","keywords":""},"mdx":{"altBody":"","status":"rdmd"},"algolia":{"recordCount":1,"publishPending":false,"updatedAt":"2024-12-19T08:59:40.248Z"},"title":"Absences and Attendances v2 APIs - Promotion to General Availability (GA)","slug":"absences-and-attendances-v2-apis-promotion-to-general-availability-ga","body":"Following up on a successful [Open Alpha](https://developer.personio.de/v2.0/changelog/attendances-and-absences-v2-apis-open-alpha), Personio is proud to announce that the Absences and Attendances v2 APIs are officially in General Availability for scaled use by all customers and partners. Changes, breaking or otherwise, to these endpoints will be communicated well in advance and we encourage our customers and partners to plan for migrating from the v1 to v2 Absences and Attendance APIs in 2025.","searchContents":"","type":"improved","hidden":false,"revision":2,"_id":"6763e07bafedbc00185d5102","user":{"name":"Amrit Vanchinathan","_id":"635be8877ecb880043fc6809"},"project":"58bec8f49d43720f0043fdb2","createdAt":"2024-12-19T08:59:39.805Z","updatedAt":"2024-12-19T08:59:39.805Z","lastUpdatedHash":"3cab6466a2490d3b8b44b73febb4228593e99eb4","__v":0},{"metadata":{"image":[],"title":"","description":"","keywords":""},"mdx":{"altBody":"","status":"rdmd"},"algolia":{"recordCount":1,"publishPending":false,"updatedAt":"2024-12-17T13:56:47.612Z"},"title":"Webhooks - Events API","slug":"webhooks-events-api","body":"Personio is proud to announce the launch of the Webhooks Events API (<https://developer.personio.de/v2.0/reference/get_v2-webhooks-id-events>), which enables our customers to obtain a list of all events associated with a specific Webhook config. to upto 30 days in the past. Users are also able to specify a query timeframe by using the 'occured_at' fields as well as an event name using the 'event_name' field.","searchContents":"","type":"added","hidden":false,"revision":2,"_id":"6761831f4762600011d83e75","user":{"name":"Amrit Vanchinathan","_id":"635be8877ecb880043fc6809"},"project":"58bec8f49d43720f0043fdb2","createdAt":"2024-12-17T13:56:47.196Z","updatedAt":"2024-12-17T13:56:47.196Z","lastUpdatedHash":"7a8430977c97c1551bd234753f790c91d2190b95","__v":0},{"metadata":{"image":[],"title":"","description":"","keywords":""},"mdx":{"altBody":"","status":"rdmd"},"algolia":{"recordCount":1,"publishPending":false,"updatedAt":"2024-12-02T14:06:12.807Z"},"title":"Time-off/Absence Type Consolidation and Improvements - v1 and v2 API","slug":"time-offabsence-type-consolidation-and-improvements-v1-and-v2-api","body":"Personio will be updating a set of absence categories to better align with market needs and enhance flexibility of absence types for all customers. The summary of the changes are present below:\n\n1. Category \"voluntary_military_service\" will be renamed to \"public_duties\" to cover more use cases.\n2. Categories \"lawful_strike\", \"unlawful_strike\", and \"lockout\" will be merged into \"strike_lockout\" to streamline handling of low-frequency absence periods.\n\nDo note that these changes will be applied to both the [v1 GET Time-off Types](https://developer.personio.de/reference/get_company-time-off-types) and [v2 Get Absence Types](https://developer.personio.de/v2.0/reference/get_v2-absence-types) endpoints and will come into effect from **January 27, 2025** \n\n**Call to Action**\n\nPlease review your integration scripts and downstream processes that depend on the categories mentioned above and ensure that the renaming and/or merging of categories does not affect the working of the integrations","searchContents":"","type":"improved","hidden":false,"revision":6,"_id":"673c9518a84691004b25e71c","user":{"name":"Amrit Vanchinathan","_id":"635be8877ecb880043fc6809"},"project":"58bec8f49d43720f0043fdb2","createdAt":"2024-11-19T13:39:36.388Z","updatedAt":"2024-12-02T14:06:12.232Z","lastUpdatedHash":"f0e0378a27319dc2e31fda0bab01ef3b18b7f41c","__v":0}],"discuss":[{"anonymous_user":{"name":"Moritz"},"algolia":{"recordCount":1,"publishPending":false,"updatedAt":"2025-04-04T09:29:33.138Z"},"title":"List employments of a given Person - Max request limit","votes":0,"voters":[],"hub2voters":[],"views":0,"type":"question","solved":false,"body":"We have 700 Persons and i need all of them with their employments.\n\nRequesting the employments for each person will lead to the max request limit. \n\nSo how can i get all Persons with there employments?","searchContents":"We have 700 Persons and i need all of them with their employments. Requesting the employments for each person will lead to the max request limit. So how can i get all Persons with there employments?","isSpam":false,"isFAQ":false,"edited":false,"comments":[],"tags":[],"revision":2,"_id":"67efa67b353ba300697c52f6","createdAt":"2025-04-04T09:29:31.568Z","updatedAt":"2025-04-04T09:29:31.568Z","project":"58bec8f49d43720f0043fdb2","initVersion":"6527bc3eb308ad001a4f25c0","__v":0,"effective_user":{"name":"Moritz","isAdmin":false},"vote_count":0,"id":"67efa67b353ba300697c52f6"},{"anonymous_user":{"name":"Michael Haupt"},"algolia":{"recordCount":1,"publishPending":false,"updatedAt":"2025-04-02T09:01:46.489Z"},"title":"extended tooling for Personio users","votes":0,"voters":[],"hub2voters":[],"views":0,"type":"question","solved":false,"body":"Hello,\n\nsince Personio's UI makes people click a lot when requesting / recording certain kinds of absence, I'd like to build some tooling.\n\nAs far as I understand, I need to obtain an API key and register an application, and also the API key gives the application I would build on my end very wide-ranging abililties (e.g., it would be able to file absence requests for everyone). If the tooling should work for individuals, I'd have to make sure only requests for the person at hand could be filed.\n\nI believe I should implement some kind of user management on my end. We have wired up Personio via Google Workspace SSO, so if I ensure people have to log in to our tool via SSO and then file requests only for the logged-in user after retrieving their ID from Personio, would that be good enough?\n\nWhat would be a best practice for that? I'll appreciate any pointer to past experience and/or documentation.\n\nMichael","searchContents":"Hello, since Personio's UI makes people click a lot when requesting / recording certain kinds of absence, I'd like to build some tooling. As far as I understand, I need to obtain an API key and register an application, and also the API key gives the application I would build on my end very wide-ranging abililties (e.g., it would be able to file absence requests for everyone). If the tooling should work for individuals, I'd have to make sure only requests for the person at hand could be filed. I believe I should implement some kind of user management on my end. We have wired up Personio via Google Workspace SSO, so if I ensure people have to log in to our tool via SSO and then file requests only for the logged-in user after retrieving their ID from Personio, would that be good enough? What would be a best practice for that? I'll appreciate any pointer to past experience and/or documentation. Michael","isSpam":false,"isFAQ":false,"edited":false,"comments":[],"tags":[],"revision":2,"_id":"67ecfcf86eea91006c702681","createdAt":"2025-04-02T09:01:44.761Z","updatedAt":"2025-04-02T09:01:44.761Z","project":"58bec8f49d43720f0043fdb2","initVersion":"6527bc3eb308ad001a4f25c0","__v":0,"effective_user":{"name":"Michael Haupt","isAdmin":false},"vote_count":0,"id":"67ecfcf86eea91006c702681"},{"anonymous_user":{"name":"Elias Fröhner"},"algolia":{"recordCount":1,"publishPending":false,"updatedAt":"2025-04-01T12:25:21.948Z"},"title":"Unable to fetch the work schedule with V2","votes":0,"voters":[],"hub2voters":[],"views":0,"type":"question","solved":false,"body":"Hi,\n\nI'm unable to request the work schedule for a person in the V2 API. Any hints?","searchContents":"Hi, I'm unable to request the work schedule for a person in the V2 API. Any hints?","isSpam":false,"isFAQ":false,"edited":false,"comments":[],"tags":[],"revision":2,"_id":"67ebdb3058154c0018dfeae8","createdAt":"2025-04-01T12:25:20.306Z","updatedAt":"2025-04-01T12:25:20.306Z","project":"58bec8f49d43720f0043fdb2","initVersion":"6527bc3eb308ad001a4f25c0","__v":0,"effective_user":{"name":"Elias Fröhner","isAdmin":false},"vote_count":0,"id":"67ebdb3058154c0018dfeae8"},{"anonymous_user":{"name":"Dominik Fischer"},"algolia":{"recordCount":1,"publishPending":false,"updatedAt":"2025-03-31T19:45:21.581Z"},"title":"AbsencePeriod End Date not correct.","votes":0,"voters":[],"hub2voters":[],"views":121,"type":"question","solved":false,"body":"Hi, I created an absence period on Personio and when fetched it gives me the response with relevant data.\n\nThe issue is with this part, \"ends_at\":\n\n```\n {\n \"absence_type\": {\n \"id\": \"595527ed-4ca8-45d1-a7c7-e946cd435f97\"\n },\n \"approval\": {\n \"status\": \"APPROVED\"\n },\n \"comment\": \"Test\",\n \"created_at\": \"2025-03-17T08:39:02.285376Z\",\n \"ends_at\": {\n \"date_time\": \"2026-07-11T00:00:00\",\n \"type\": \"SECOND_HALF\"\n },\n \"id\": \"fc84c604-e9d9-43cc-8cbd-b2eabcaea497\",\n \"person\": {\n \"id\": \"23851395\"\n },\n \"starts_from\": {\n \"date_time\": \"2026-07-06T00:00:00\",\n \"type\": \"SECOND_HALF\"\n },\n \"timezone_id\": \"Europe/Berlin\",\n \"updated_at\": \"2025-03-20T14:58:13.163223Z\"\n }\n```\n\nIn my calendar the absence period actually ends the day before, 2026-07-10.\n\nThis happens to all my entries. Is that an error or are there any weird timezone shenanigans going on?","searchContents":"Hi, I created an absence period on Personio and when fetched it gives me the response with relevant data. The issue is with this part, \"ends_at\": { \"absence_type\": { \"id\": \"595527ed-4ca8-45d1-a7c7-e946cd435f97\" }, \"approval\": { \"status\": \"APPROVED\" }, \"comment\": \"Test\", \"created_at\": \"2025-03-17T08:39:02.285376Z\", \"ends_at\": { \"date_time\": \"2026-07-11T00:00:00\", \"type\": \"SECOND_HALF\" }, \"id\": \"fc84c604-e9d9-43cc-8cbd-b2eabcaea497\", \"person\": { \"id\": \"23851395\" }, \"starts_from\": { \"date_time\": \"2026-07-06T00:00:00\", \"type\": \"SECOND_HALF\" }, \"timezone_id\": \"Europe/Berlin\", \"updated_at\": \"2025-03-20T14:58:13.163223Z\" } In my calendar the absence period actually ends the day before, 2026-07-10. This happens to all my entries. Is that an error or are there any weird timezone shenanigans going on?","isSpam":false,"isFAQ":false,"edited":false,"comments":["67e6acbd42e9df0010262c22"],"tags":[],"revision":124,"_id":"67e690c3f3416c003e28eb87","createdAt":"2025-03-28T12:06:27.466Z","updatedAt":"2025-03-28T12:06:27.466Z","project":"58bec8f49d43720f0043fdb2","initVersion":"6527bc3eb308ad001a4f25c0","__v":1,"effective_user":{"name":"Dominik Fischer","isAdmin":false},"vote_count":0,"id":"67e690c3f3416c003e28eb87"},{"anonymous_user":{"name":"Martin Gregoire"},"algolia":{"recordCount":1,"publishPending":false,"updatedAt":"2025-03-31T20:14:34.248Z"},"title":"Employees endpoint does not return status attribute","votes":0,"voters":[],"hub2voters":[],"views":157,"type":"question","solved":true,"body":"Hey there! I'm looking into an issue where our app cannot get the status of an employee.\n\nWhile querying the Personio API endpoints, I noticed that indeed the `status` attribute is absent.\n\nFor reference: [Changelog](https://developer.personio.de/v1.0/changelog/employee-api-added-status-and-supervisor_id-fields)\n\n[List employees API](https://developer.personio.de/v1.0/reference/get_company-employees)\n\n[Get employee API](https://developer.personio.de/v1.0/reference/get_company-employees-employee-id)\n\nHere in the example responses we see:\n\n```json json\n \"status\": {\n \"label\": \"Status\",\n \"value\": \"active\",\n \"type\": \"standard\",\n \"universal_id\": \"status\"\n },\n```\n\nI tested this with cURL. Please have a look:\n\n```shell\ncurl --request GET \\\n --url 'https://api.personio.de/v1/company/employees?limit=1&offset=0&attributes[]=status&attributes[]=first_name' \\\n --header 'accept: application/json' \\\n --header 'authorization: Bearer ...'\n```\n\nThis is the response:\n\n```json JSON\n{\n \"success\": true,\n \"data\": [\n {\n \"type\": \"Employee\",\n \"attributes\": {\n \"id\": {\n \"label\": \"ID\",\n \"value\": 12345,\n \"type\": \"integer\",\n \"universal_id\": \"id\"\n },\n \"first_name\": {\n \"label\": \"First name\",\n \"value\": \"Foo\",\n \"type\": \"standard\",\n \"universal_id\": \"first_name\"\n }\n }\n }\n ],\n \"metadata\": {\n \"total_elements\": 183,\n \"current_page\": 0,\n \"total_pages\": 183\n },\n \"offset\": 0,\n \"limit\": 1\n}\n```\n\nAs you can see, only the `first_name` attribute is present. `status` is missing.\n\nThe same happens when not passing any `attributes` query parameter.\n\nIt's similar for the \"Get Employee by ID\" endpoint - the response does not contain the `status` among all the attributes.\n\n```shell\ncurl --request GET \\\n --url 'https://api.personio.de/v1/company/employees/12345' \\\n --header 'accept: application/json' \\\n --header 'authorization: Bearer ...'\n```\n\nAre we doing something wrong here?\n\nAny help would be greatly appreciated.","searchContents":"Hey there! I'm looking into an issue where our app cannot get the status of an employee. While querying the Personio API endpoints, I noticed that indeed the status attribute is absent. For reference: Changelog List employees API Get employee API Here in the example responses we see: \"status\": { \"label\": \"Status\", \"value\": \"active\", \"type\": \"standard\", \"universal_id\": \"status\" }, I tested this with cURL. Please have a look: curl --request GET \\ --url 'https://api.personio.de/v1/company/employees?limit=1&offset=0&attributes[]=status&attributes[]=first_name' \\ --header 'accept: application/json' \\ --header 'authorization: Bearer ...' This is the response: { \"success\": true, \"data\": [ { \"type\": \"Employee\", \"attributes\": { \"id\": { \"label\": \"ID\", \"value\": 12345, \"type\": \"integer\", \"universal_id\": \"id\" }, \"first_name\": { \"label\": \"First name\", \"value\": \"Foo\", \"type\": \"standard\", \"universal_id\": \"first_name\" } } } ], \"metadata\": { \"total_elements\": 183, \"current_page\": 0, \"total_pages\": 183 }, \"offset\": 0, \"limit\": 1 } As you can see, only the first_name attribute is present. status is missing. The same happens when not passing any attributes query parameter. It's similar for the \"Get Employee by ID\" endpoint - the response does not contain the status among all the attributes. curl --request GET \\ --url 'https://api.personio.de/v1/company/employees/12345' \\ --header 'accept: application/json' \\ --header 'authorization: Bearer ...' Are we doing something wrong here? Any help would be greatly appreciated.","isSpam":false,"isFAQ":false,"edited":false,"comments":["67e5409637b2bd003d7cc61a","67e55aa80f3981004a7e665d","67e66d70425b79004596777d"],"tags":[],"revision":162,"_id":"67e529e51268880019d5fa07","createdAt":"2025-03-27T10:35:17.520Z","updatedAt":"2025-03-27T10:35:17.520Z","project":"58bec8f49d43720f0043fdb2","initVersion":"58bec8f49d43720f0043fdb5","__v":3,"effective_user":{"name":"Martin Gregoire","isAdmin":false},"vote_count":0,"id":"67e529e51268880019d5fa07"}],"docsCategories":[{"_id":"6527bc3eb308ad001a4f2578","project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","isAPI":false,"reference":false,"createdAt":"2019-05-28T07:38:55.311Z","order":0,"slug":"getting-started","title":"Getting started","__v":0,"pages":[{"_id":"6527bc3eb308ad001a4f2595","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[],"examples":{"codes":[]}},"title":"Get started with Personio API","type":"basic","slug":"getting-started-with-the-personio-api","order":0,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","createdAt":"2020-08-20T08:57:44.027Z","category":"6527bc3eb308ad001a4f2578","parentDoc":null,"deprecated":false,"icon":"","mdx":{},"isBodyEmpty":false,"children":[{"_id":"6527bc3eb308ad001a4f259e","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[],"examples":{"codes":[]}},"title":"Marketplace TOS & API Policy","type":"basic","slug":"tos-api-security-1","order":0,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","createdAt":"2021-10-08T07:17:52.185Z","parentDoc":"6527bc3eb308ad001a4f2595","category":"6527bc3eb308ad001a4f2578","icon":"","isBodyEmpty":false,"children":[]}]},{"_id":"6527bc3eb308ad001a4f25b6","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[],"examples":{"codes":[]}},"title":"For product partners","icon":"","type":"basic","slug":"ipaas-partner","order":999,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","category":"6527bc3eb308ad001a4f2578","createdAt":"2023-01-27T16:06:57.607Z","mdx":{},"isBodyEmpty":false,"children":[]}]},{"_id":"6527bc3eb308ad001a4f2574","version":"6527bc3eb308ad001a4f25c0","from_sync":false,"isAPI":false,"reference":false,"slug":"documentation","__v":0,"createdAt":"2017-03-07T14:51:33.011Z","order":3,"project":"58bec8f49d43720f0043fdb2","title":"Recruiting","pages":[{"_id":"6527bc3eb308ad001a4f257f","category":"6527bc3eb308ad001a4f2574","slug":"retrieving-open-job-positions","link_external":false,"link_url":"","title":"Retrieving open positions","type":"basic","isReference":false,"parentDoc":null,"order":0,"sync_unique":"","api":{"params":[],"url":"","method":"get","results":{"codes":[{"language":"json","code":"{}","name":"","status":200},{"status":400,"language":"json","code":"{}","name":""}]},"auth":"required"},"createdAt":"2017-03-24T12:00:34.319Z","hidden":false,"previousSlug":"","deprecated":false,"icon":"","isBodyEmpty":false,"children":[{"_id":"6527bc3eb308ad001a4f2581","createdAt":"2017-03-24T12:13:15.655Z","hidden":false,"sync_unique":"","parentDoc":"6527bc3eb308ad001a4f257f","type":"basic","category":"6527bc3eb308ad001a4f2574","order":0,"slug":"integration-via-iframe","title":"Integration via Iframe","api":{"auth":"required","params":[],"url":"","method":"get","results":{"codes":[{"code":"{}","name":"","status":200,"language":"json"},{"name":"","status":400,"language":"json","code":"{}"}]}},"isReference":false,"link_external":false,"link_url":"","previousSlug":"","deprecated":false,"icon":"","isBodyEmpty":false,"children":[]},{"_id":"6527bc3eb308ad001a4f2580","link_url":"","api":{"url":"","method":"get","results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"auth":"required","params":[]},"hidden":false,"isReference":false,"title":"Integration via code","category":"6527bc3eb308ad001a4f2574","slug":"integration-of-open-positions","createdAt":"2017-03-24T12:05:37.669Z","order":1,"sync_unique":"","link_external":false,"parentDoc":"6527bc3eb308ad001a4f257f","type":"basic","previousSlug":"","deprecated":false,"icon":"","isBodyEmpty":false,"children":[]}]},{"_id":"6527bc3eb308ad001a4f257d","parentDoc":null,"slug":"applications-endpoint","order":1,"title":"Passing applications to Personio","link_url":"","link_external":false,"sync_unique":"","api":{"auth":"required","method":"get","params":[],"results":{"codes":[{"language":"json","code":"{}","name":"","status":200},{"status":400,"language":"json","code":"{}","name":""}]},"url":""},"hidden":false,"category":"6527bc3eb308ad001a4f2574","createdAt":"2017-03-07T14:51:33.051Z","isReference":false,"type":"basic","previousSlug":"","deprecated":false,"icon":"","mdx":{},"isBodyEmpty":false,"children":[]}]},{"_id":"66d1a4bad7abe20018cfe6dc","title":"Shift Planning Integration Guide","slug":"shift-planning-integration-guide","order":9999,"reference":false,"project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","createdAt":"2024-08-30T10:53:46.508Z","__v":0,"pages":[{"_id":"66d1aa600d08830052a3f260","api":{"method":"get","url":"","auth":"required","params":[]},"title":"Key points for Implementing Shift Planning Integration with Personio HRIS","icon":"","type":"basic","slug":"key-points-for-implementing-shift-planning-integration-with-personio-hris","order":999,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","category":"66d1a4bad7abe20018cfe6dc","createdAt":"2024-08-30T11:17:52.018Z","isBodyEmpty":false,"children":[]},{"_id":"66d1ab0b5f5a870012b2b896","api":{"method":"get","url":"","auth":"required","params":[]},"title":"Introduction and Prerequisites","icon":"","type":"basic","slug":"introduction-and-prerequisites","order":999,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","category":"66d1a4bad7abe20018cfe6dc","createdAt":"2024-08-30T11:20:43.127Z","isBodyEmpty":false,"children":[]},{"_id":"66d1b115700490004b9e01ac","api":{"method":"get","url":"","auth":"required","params":[]},"title":"Initial core data sync","icon":"","type":"basic","slug":"initial-core-data-sync","order":999,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","category":"66d1a4bad7abe20018cfe6dc","createdAt":"2024-08-30T11:46:29.115Z","isBodyEmpty":false,"children":[]},{"_id":"66d1b21e834b25000f5935ed","api":{"method":"get","url":"","auth":"required","params":[]},"title":"Event-driven data from Personio","icon":"","type":"basic","slug":"event-driven-data-from-personio","order":999,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","category":"66d1a4bad7abe20018cfe6dc","createdAt":"2024-08-30T11:50:54.975Z","isBodyEmpty":false,"children":[{"_id":"66d822efef9868003667ef38","api":{"method":"get","url":"","auth":"required","params":[]},"title":"Attendance & Absence Events","icon":"","type":"basic","slug":"attendance-and-absence-events","order":999,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"person-and-employment-updates","parentDoc":"66d1b21e834b25000f5935ed","category":"66d1a4bad7abe20018cfe6dc","createdAt":"2024-09-04T09:05:51.828Z","isBodyEmpty":false,"children":[]},{"_id":"66d824c555113b004a63dceb","api":{"method":"get","url":"","auth":"required","params":[]},"title":"Handling Logic for Shift Planning","icon":"","type":"basic","slug":"handling-logic","order":999,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","parentDoc":"66d1b21e834b25000f5935ed","category":"66d1a4bad7abe20018cfe6dc","createdAt":"2024-09-04T09:13:41.400Z","isBodyEmpty":false,"children":[]}]},{"_id":"66d82d1dd668c9003c82d996","api":{"method":"get","url":"","auth":"required","params":[]},"title":"Guidelines on when not to update Personio","icon":"","type":"basic","slug":"guidelines-on-when-not-to-update-personio","order":999,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","category":"66d1a4bad7abe20018cfe6dc","createdAt":"2024-09-04T09:49:17.146Z","isBodyEmpty":false,"children":[]},{"_id":"66d82e55d7f631002059e968","api":{"method":"get","url":"","auth":"required","params":[]},"title":"Guidelines for syncing information into Personio","icon":"","type":"basic","slug":"guidelines-for-syncing-information-into-personio","order":999,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","category":"66d1a4bad7abe20018cfe6dc","createdAt":"2024-09-04T09:54:29.143Z","mdx":{},"isBodyEmpty":false,"children":[]}]}],"refCategories":[{"_id":"6527bc3eb308ad001a4f2576","createdAt":"2017-03-19T14:34:54.117Z","from_sync":false,"order":1,"title":"Overview","__v":0,"project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","slug":"overview","isAPI":false,"reference":true,"pages":[{"_id":"6527bc3eb308ad001a4f257e","type":"basic","category":"6527bc3eb308ad001a4f2576","link_url":"","sync_unique":"","title":"Introduction","createdAt":"2017-03-19T14:40:54.670Z","parentDoc":null,"slug":"introduction","isReference":true,"api":{"method":"get","results":{"codes":[{"status":200,"language":"json","code":"{}","name":""},{"status":400,"language":"json","code":"{}","name":""}]},"auth":"required","params":[],"url":"","examples":{"codes":[]}},"hidden":false,"link_external":false,"order":0,"deprecated":false,"previousSlug":"","icon":"","isBodyEmpty":false,"children":[]},{"_id":"6527bc3eb308ad001a4f25a8","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[],"examples":{"codes":[]}},"title":"Include our headers in your requests","type":"basic","slug":"include-our-headers-in-your-requests","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","createdAt":"2022-01-20T11:02:09.287Z","category":"6527bc3eb308ad001a4f2576","parentDoc":null,"icon":"","isBodyEmpty":false,"children":[]}]},{"_id":"6527d2b80618570039103154","title":"Authentication","slug":"authentication","order":2,"reference":true,"project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","createdAt":"2023-10-12T11:04:24.130Z","__v":0,"pages":[{"_id":"655f5292a78ced0047e54ab2","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"6527d2b80618570039103152"},"title":"Authentication","icon":"","type":"basic","slug":"authentication","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Authentication","link_url":"","link_external":false,"previousSlug":"","category":"6527d2b80618570039103154","createdAt":"2023-11-23T13:24:34.274Z","parentDoc":null,"isBodyEmpty":false,"children":[{"_id":"6527d2b9061857003910315d","api":{"method":"post","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"6527d2b80618570039103152"},"title":"Obtain Access Token","icon":"","type":"endpoint","slug":"post_v2-auth-token","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"post_v2-auth-token","link_url":"","link_external":false,"previousSlug":"","category":"6527d2b80618570039103154","createdAt":"2023-10-12T11:04:25.487Z","parentDoc":"655f5292a78ced0047e54ab2","isBodyEmpty":true,"children":[]},{"_id":"66977fc8f3c8ae00450b6082","api":{"method":"post","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"6527d2b80618570039103152"},"title":"Revoke Access Token","icon":"","type":"endpoint","slug":"post_v2-auth-revoke","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"post_v2-auth-revoke","link_url":"","link_external":false,"previousSlug":"","category":"6527d2b80618570039103154","createdAt":"2024-07-17T08:24:40.631Z","parentDoc":"655f5292a78ced0047e54ab2","isBodyEmpty":true,"children":[]}]}]},{"_id":"655cb153e417660068aeead2","title":"Webhooks Management API","slug":"webhooks-management-api","order":3,"reference":true,"project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","createdAt":"2023-11-21T13:32:03.788Z","__v":0,"pages":[{"_id":"6613c2e073f13200184b44f7","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"655cb153e417660068aeead0"},"title":"Webhooks","icon":"","type":"basic","slug":"webhooks","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Webhooks","link_url":"","link_external":false,"previousSlug":"webhooks-1","category":"655cb153e417660068aeead2","createdAt":"2024-04-08T10:11:44.073Z","parentDoc":null,"mdx":{},"isBodyEmpty":false,"children":[{"_id":"655cb157e417660068aeead5","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"655cb153e417660068aeead0"},"title":"List webhooks.","icon":"","type":"endpoint","slug":"get_v2-webhooks","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-webhooks","link_url":"","link_external":false,"previousSlug":"","category":"655cb153e417660068aeead2","createdAt":"2023-11-21T13:32:07.582Z","parentDoc":"6613c2e073f13200184b44f7","mdx":{},"isBodyEmpty":true,"children":[]},{"_id":"655cb157e417660068aeead6","api":{"method":"post","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"655cb153e417660068aeead0"},"title":"Create new webhook.","icon":"","type":"endpoint","slug":"post_v2-webhooks","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"post_v2-webhooks","link_url":"","link_external":false,"previousSlug":"","category":"655cb153e417660068aeead2","createdAt":"2023-11-21T13:32:07.589Z","parentDoc":"6613c2e073f13200184b44f7","mdx":{},"isBodyEmpty":true,"children":[]},{"_id":"65e86a5628aa640020d6ae86","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"655cb153e417660068aeead0"},"title":"Get a webhook.","icon":"","type":"endpoint","slug":"get_v2-webhooks-id","order":2,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-webhooks-id","link_url":"","link_external":false,"previousSlug":"","category":"655cb153e417660068aeead2","createdAt":"2024-03-06T13:06:30.167Z","parentDoc":"6613c2e073f13200184b44f7","mdx":{},"isBodyEmpty":true,"children":[]},{"_id":"655cb157e417660068aeead7","api":{"method":"patch","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"655cb153e417660068aeead0"},"title":"Update a webhook.","icon":"","type":"endpoint","slug":"patch_v2-webhooks-id","order":3,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"patch_v2-webhooks-id","link_url":"","link_external":false,"previousSlug":"","category":"655cb153e417660068aeead2","createdAt":"2023-11-21T13:32:07.591Z","parentDoc":"6613c2e073f13200184b44f7","mdx":{},"isBodyEmpty":true,"children":[]},{"_id":"655cb157e417660068aeead8","api":{"method":"delete","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"655cb153e417660068aeead0"},"title":"Delete a webhook.","icon":"","type":"endpoint","slug":"delete_v2-webhooks-id","order":4,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"delete_v2-webhooks-id","link_url":"","link_external":false,"previousSlug":"","category":"655cb153e417660068aeead2","createdAt":"2023-11-21T13:32:07.594Z","parentDoc":"6613c2e073f13200184b44f7","mdx":{},"isBodyEmpty":true,"children":[]},{"_id":"669a2487cb2d0c00690c9fe8","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"655cb153e417660068aeead0"},"title":"Get webhook delivery activity","icon":"","type":"endpoint","slug":"get_v2-webhooks-id-activity","order":5,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-webhooks-id-activity","link_url":"","link_external":false,"previousSlug":"","category":"655cb153e417660068aeead2","createdAt":"2024-07-19T08:32:07.706Z","parentDoc":"6613c2e073f13200184b44f7","mdx":{},"isBodyEmpty":true,"children":[]},{"_id":"6761558554c60e001ee7b49c","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"655cb153e417660068aeead0"},"title":"Get webhook events","icon":"","type":"endpoint","slug":"get_v2-webhooks-id-events","order":6,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-webhooks-id-events","link_url":"","link_external":false,"previousSlug":"","category":"655cb153e417660068aeead2","createdAt":"2024-12-17T10:42:13.849Z","parentDoc":"6613c2e073f13200184b44f7","isBodyEmpty":true,"children":[]}]}]},{"_id":"65fc0bc31513cc001c8c83c5","title":"Document Management","slug":"document-management","order":5,"reference":true,"project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","createdAt":"2024-03-21T10:28:19.545Z","__v":0,"pages":[{"_id":"65fc0bc41513cc001c8c83c6","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"65fc0bc31513cc001c8c83c3"},"title":"Document Management","icon":"","type":"basic","slug":"document-management","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Document Management","link_url":"","link_external":false,"previousSlug":"","category":"65fc0bc31513cc001c8c83c5","createdAt":"2024-03-21T10:28:20.402Z","parentDoc":null,"mdx":{},"isBodyEmpty":false,"children":[{"_id":"65fc0bc41513cc001c8c83c8","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"65fc0bc31513cc001c8c83c3"},"title":"List document metadata.","icon":"","type":"endpoint","slug":"get_v2-document-management-documents","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-document-management-documents","link_url":"","link_external":false,"previousSlug":"","category":"65fc0bc31513cc001c8c83c5","createdAt":"2024-03-21T10:28:20.482Z","parentDoc":"65fc0bc41513cc001c8c83c6","isBodyEmpty":true,"children":[]},{"_id":"65fc0bc41513cc001c8c83c9","api":{"method":"patch","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"65fc0bc31513cc001c8c83c3"},"title":"Update document metadata.","icon":"","type":"endpoint","slug":"patch_v2-document-management-documents-document-id","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"patch_v2-document-management-documents-document-id","link_url":"","link_external":false,"previousSlug":"","category":"65fc0bc31513cc001c8c83c5","createdAt":"2024-03-21T10:28:20.483Z","parentDoc":"65fc0bc41513cc001c8c83c6","isBodyEmpty":true,"children":[]},{"_id":"65fc0bc41513cc001c8c83ca","api":{"method":"delete","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"65fc0bc31513cc001c8c83c3"},"title":"Delete document.","icon":"","type":"endpoint","slug":"delete_v2-document-management-documents-document-id","order":2,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"delete_v2-document-management-documents-document-id","link_url":"","link_external":false,"previousSlug":"","category":"65fc0bc31513cc001c8c83c5","createdAt":"2024-03-21T10:28:20.483Z","parentDoc":"65fc0bc41513cc001c8c83c6","isBodyEmpty":true,"children":[]},{"_id":"65fc0bc41513cc001c8c83cb","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"65fc0bc31513cc001c8c83c3"},"title":"Download document file.","icon":"","type":"endpoint","slug":"get_v2-document-management-documents-document-id-download","order":3,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-document-management-documents-document-id-download","link_url":"","link_external":false,"previousSlug":"","category":"65fc0bc31513cc001c8c83c5","createdAt":"2024-03-21T10:28:20.484Z","parentDoc":"65fc0bc41513cc001c8c83c6","isBodyEmpty":true,"children":[]}]}]},{"_id":"66215d6ad2bf100019706d80","title":"Person","slug":"person-3","order":6,"reference":true,"project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","createdAt":"2024-04-18T17:50:34.867Z","__v":0,"pages":[{"_id":"662f75edaa8116005aac11bd","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"66215d6ad2bf100019706d7e"},"title":"Persons","icon":"","type":"basic","slug":"persons-closed-alpha","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Persons (Closed Alpha)","link_url":"","link_external":false,"previousSlug":"","category":"66215d6ad2bf100019706d80","createdAt":"2024-04-29T10:26:53.641Z","parentDoc":null,"isBodyEmpty":false,"children":[{"_id":"66215d6bd2bf100019706d83","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66215d6ad2bf100019706d7e"},"title":"List persons.","icon":"","type":"endpoint","slug":"get_v2-persons","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-persons","link_url":"","link_external":false,"previousSlug":"","category":"66215d6ad2bf100019706d80","createdAt":"2024-04-18T17:50:35.987Z","parentDoc":"662f75edaa8116005aac11bd","isBodyEmpty":true,"children":[]},{"_id":"66a2407e1b5fa0004ac4d90a","api":{"method":"post","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66a2407d1b5fa0004ac4d903"},"title":"Create a new Person and Employment.","icon":"","type":"endpoint","slug":"post_v2-persons","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"post_v2-persons","link_url":"","link_external":false,"previousSlug":"","category":"66215d6ad2bf100019706d80","createdAt":"2024-07-25T12:09:34.600Z","parentDoc":"662f75edaa8116005aac11bd","isBodyEmpty":true,"children":[]},{"_id":"66215d6bd2bf100019706d84","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66215d6ad2bf100019706d7e"},"title":"Retrieve a person.","icon":"","type":"endpoint","slug":"get_v2-persons-id","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-persons-id","link_url":"","link_external":false,"previousSlug":"","category":"66215d6ad2bf100019706d80","createdAt":"2024-04-18T17:50:35.988Z","parentDoc":"662f75edaa8116005aac11bd","isBodyEmpty":true,"children":[]},{"_id":"66a2407e1b5fa0004ac4d90b","api":{"method":"patch","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66a2407d1b5fa0004ac4d903"},"title":"Update a Person.","icon":"","type":"endpoint","slug":"patch_v2-persons-person-id","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"patch_v2-persons-person-id","link_url":"","link_external":false,"previousSlug":"","category":"66215d6ad2bf100019706d80","createdAt":"2024-07-25T12:09:34.602Z","parentDoc":"662f75edaa8116005aac11bd","isBodyEmpty":true,"children":[]},{"_id":"66a2407e1b5fa0004ac4d90c","api":{"method":"delete","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66a2407d1b5fa0004ac4d903"},"title":"Delete a Person.","icon":"","type":"endpoint","slug":"delete_v2-persons-person-id","order":2,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"delete_v2-persons-person-id","link_url":"","link_external":false,"previousSlug":"","category":"66215d6ad2bf100019706d80","createdAt":"2024-07-25T12:09:34.602Z","parentDoc":"662f75edaa8116005aac11bd","isBodyEmpty":true,"children":[]}]}]},{"_id":"66215d6939b32f001096f59f","title":"Employment","slug":"employment-4","order":7,"reference":true,"project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","createdAt":"2024-04-18T17:50:33.167Z","__v":0,"pages":[{"_id":"662f75f0d0f6a000192a4893","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"66215d6939b32f001096f59d"},"title":"Employment","icon":"","type":"basic","slug":"employment-closed-alpha","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Employment (Closed Alpha)","link_url":"","link_external":false,"previousSlug":"","category":"66215d6939b32f001096f59f","createdAt":"2024-04-29T10:26:56.532Z","parentDoc":null,"isBodyEmpty":false,"children":[{"_id":"66215d6939b32f001096f5a2","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66215d6939b32f001096f59d"},"title":"List employments of a given Person.","icon":"","type":"endpoint","slug":"get_v2-persons-person-id-employments","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-persons-person-id-employments","link_url":"","link_external":false,"previousSlug":"","category":"66215d6939b32f001096f59f","createdAt":"2024-04-18T17:50:33.998Z","parentDoc":"662f75f0d0f6a000192a4893","isBodyEmpty":true,"children":[]},{"_id":"66a2407e1b5fa0004ac4d90d","api":{"method":"patch","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66a2407d1b5fa0004ac4d903"},"title":"Update an Employment.","icon":"","type":"endpoint","slug":"patch_v2-persons-person-id-employments-employment-id","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"patch_v2-persons-person-id-employments-employment-id","link_url":"","link_external":false,"previousSlug":"","category":"66215d6939b32f001096f59f","createdAt":"2024-07-25T12:09:34.603Z","parentDoc":"662f75f0d0f6a000192a4893","isBodyEmpty":true,"children":[]},{"_id":"66215d6939b32f001096f5a3","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66215d6939b32f001096f59d"},"title":"Retrieve an employment.","icon":"","type":"endpoint","slug":"get_v2-persons-person-id-employments-id","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-persons-person-id-employments-id","link_url":"","link_external":false,"previousSlug":"","category":"66215d6939b32f001096f59f","createdAt":"2024-04-18T17:50:33.999Z","parentDoc":"662f75f0d0f6a000192a4893","isBodyEmpty":true,"children":[]}]}]},{"_id":"663341c29091f700423214af","title":"Payroll Integrations API","slug":"payroll-integrations-api","order":8,"reference":true,"project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","createdAt":"2024-05-02T07:33:22.692Z","__v":0,"pages":[{"_id":"663341c39091f700423214b0","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"663341c29091f700423214ad"},"title":"Compensations","icon":"","type":"basic","slug":"compensations-1","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Compensations","link_url":"","link_external":false,"previousSlug":"","category":"663341c29091f700423214af","createdAt":"2024-05-02T07:33:23.420Z","parentDoc":null,"mdx":{},"isBodyEmpty":true,"children":[{"_id":"663341c2e0cd1e005c14bf90","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"663341c1e0cd1e005c14bf8b"},"title":"List Compensation Types","icon":"","type":"endpoint","slug":"get_v2-compensations-types","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-compensations-types","link_url":"","link_external":false,"previousSlug":"","category":"663341c29091f700423214af","createdAt":"2024-05-02T07:33:22.162Z","parentDoc":"663341c39091f700423214b0","isBodyEmpty":true,"children":[]},{"_id":"66339bf9c69bfa004b65f9ce","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"663341c29091f700423214ad"},"title":"List compensations.","icon":"","type":"endpoint","slug":"get_v2-compensations","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-compensations","link_url":"","link_external":false,"previousSlug":"","category":"663341c29091f700423214af","createdAt":"2024-05-02T13:58:17.383Z","parentDoc":"663341c39091f700423214b0","mdx":{},"isBodyEmpty":true,"children":[]},{"_id":"66339bf9c69bfa004b65f9cf","api":{"method":"post","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"663341c29091f700423214ad"},"title":"Create Compensation.","icon":"","type":"endpoint","slug":"post_v2-compensations","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"post_v2-compensations","link_url":"","link_external":false,"previousSlug":"","category":"663341c29091f700423214af","createdAt":"2024-05-02T13:58:17.384Z","parentDoc":"663341c39091f700423214b0","mdx":{},"isBodyEmpty":true,"children":[]},{"_id":"663341c2e0cd1e005c14bf91","api":{"method":"post","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"663341c1e0cd1e005c14bf8b"},"title":"Create Compensation Types","icon":"","type":"endpoint","slug":"post_v2-compensations-types","order":2,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"post_v2-compensations-types","link_url":"","link_external":false,"previousSlug":"","category":"663341c29091f700423214af","createdAt":"2024-05-02T07:33:22.163Z","parentDoc":"663341c39091f700423214b0","isBodyEmpty":true,"children":[]}]}]},{"_id":"664c75e859e7480036248e1a","title":"Organization Management","slug":"organization-management","order":9,"reference":true,"project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","createdAt":"2024-05-21T10:22:32.672Z","__v":0,"pages":[{"_id":"66a11afd486de70025987739","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"664c75e859e7480036248e18"},"title":"Org Units","icon":"","type":"basic","slug":"org-units","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Org Units","link_url":"","link_external":false,"previousSlug":"","category":"664c75e859e7480036248e1a","createdAt":"2024-07-24T15:17:17.465Z","parentDoc":null,"isBodyEmpty":true,"children":[{"_id":"66a11afd486de7002598773b","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"664c75e859e7480036248e18"},"title":"Retrieves an Org Unit.","icon":"","type":"endpoint","slug":"getorgunit-1","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"getOrgUnit","link_url":"","link_external":false,"previousSlug":"","category":"664c75e859e7480036248e1a","createdAt":"2024-07-24T15:17:17.491Z","parentDoc":"66a11afd486de70025987739","isBodyEmpty":true,"children":[]}]}]},{"_id":"66a11ab16c0a50006290acb4","title":"Legal Entities","slug":"legal-entities","order":10,"reference":true,"project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","createdAt":"2024-07-24T15:16:01.320Z","__v":0,"pages":[{"_id":"66a11ab26c0a50006290acb5","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"66a11ab16c0a50006290acb2"},"title":"Legal Entities","icon":"","type":"basic","slug":"legal-entities-1","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Legal Entities","link_url":"","link_external":false,"previousSlug":"","category":"66a11ab16c0a50006290acb4","createdAt":"2024-07-24T15:16:02.552Z","parentDoc":null,"isBodyEmpty":true,"children":[{"_id":"66a11ab26c0a50006290acb7","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66a11ab16c0a50006290acb2"},"title":"List legal entities.","icon":"","type":"endpoint","slug":"listlegalentities-1","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"listLegalEntities","link_url":"","link_external":false,"previousSlug":"","category":"66a11ab16c0a50006290acb4","createdAt":"2024-07-24T15:16:02.574Z","parentDoc":"66a11ab26c0a50006290acb5","isBodyEmpty":true,"children":[]},{"_id":"66a11ab26c0a50006290acb8","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66a11ab16c0a50006290acb2"},"title":"Retrieves a legal entity.","icon":"","type":"endpoint","slug":"getlegalentitybyid-1","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"getLegalEntityById","link_url":"","link_external":false,"previousSlug":"","category":"66a11ab16c0a50006290acb4","createdAt":"2024-07-24T15:16:02.574Z","parentDoc":"66a11ab26c0a50006290acb5","isBodyEmpty":true,"children":[]}]}]},{"_id":"66d9b8948761d7005adb7554","title":"Absence Period API","slug":"absence-period-api","order":13,"reference":true,"project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","createdAt":"2024-09-05T13:56:36.869Z","__v":0,"pages":[{"_id":"66d9b8958761d7005adb7555","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"66d9b8948761d7005adb7552"},"title":"Absence Periods","icon":"","type":"basic","slug":"absence-periods-closed-alpha","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Absence Periods (Closed Alpha)","link_url":"","link_external":false,"previousSlug":"","category":"66d9b8948761d7005adb7554","createdAt":"2024-09-05T13:56:37.792Z","mdx":{},"isBodyEmpty":true,"children":[{"_id":"66d9b8958761d7005adb755b","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66d9b8948761d7005adb7552"},"title":"Retrieves an absence period by ID.","icon":"","type":"endpoint","slug":"get_v2-absence-periods-id","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-absence-periods-id","link_url":"","link_external":false,"previousSlug":"","category":"66d9b8948761d7005adb7554","createdAt":"2024-09-05T13:56:37.855Z","parentDoc":"66d9b8958761d7005adb7555","isBodyEmpty":true,"children":[]},{"_id":"66d9b8958761d7005adb755c","api":{"method":"delete","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66d9b8948761d7005adb7552"},"title":"Deletes an absence period by ID.","icon":"","type":"endpoint","slug":"delete_v2-absence-periods-id","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"delete_v2-absence-periods-id","link_url":"","link_external":false,"previousSlug":"","category":"66d9b8948761d7005adb7554","createdAt":"2024-09-05T13:56:37.856Z","parentDoc":"66d9b8958761d7005adb7555","isBodyEmpty":true,"children":[]},{"_id":"66d9b8958761d7005adb755d","api":{"method":"patch","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66d9b8948761d7005adb7552"},"title":"Updates an absence period by ID.","icon":"","type":"endpoint","slug":"patch_v2-absence-periods-id","order":2,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"patch_v2-absence-periods-id","link_url":"","link_external":false,"previousSlug":"","category":"66d9b8948761d7005adb7554","createdAt":"2024-09-05T13:56:37.856Z","parentDoc":"66d9b8958761d7005adb7555","isBodyEmpty":true,"children":[]},{"_id":"66d9b8958761d7005adb755f","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66d9b8948761d7005adb7552"},"title":"List absence periods.","icon":"","type":"endpoint","slug":"get_v2-absence-periods","order":3,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-absence-periods","link_url":"","link_external":false,"previousSlug":"","category":"66d9b8948761d7005adb7554","createdAt":"2024-09-05T13:56:37.857Z","parentDoc":"66d9b8958761d7005adb7555","isBodyEmpty":true,"children":[]},{"_id":"66d9b8958761d7005adb7560","api":{"method":"post","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66d9b8948761d7005adb7552"},"title":"Creates a new absence period.","icon":"","type":"endpoint","slug":"post_v2-absence-periods","order":4,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"post_v2-absence-periods","link_url":"","link_external":false,"previousSlug":"","category":"66d9b8948761d7005adb7554","createdAt":"2024-09-05T13:56:37.857Z","parentDoc":"66d9b8958761d7005adb7555","isBodyEmpty":true,"children":[]}]},{"_id":"66d9b8958761d7005adb7556","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"66d9b8948761d7005adb7552"},"title":"Absence Periods Breakdowns","icon":"","type":"basic","slug":"absence-periods-breakdowns-closed-alpha","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Absence Periods Breakdowns (Closed Alpha)","link_url":"","link_external":false,"previousSlug":"","category":"66d9b8948761d7005adb7554","createdAt":"2024-09-05T13:56:37.793Z","mdx":{},"isBodyEmpty":true,"children":[{"_id":"66d9b8958761d7005adb755e","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66d9b8948761d7005adb7552"},"title":"Retrieves daily absence period breakdowns for a given absence period.","icon":"","type":"endpoint","slug":"get_v2-absence-periods-id-breakdowns","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-absence-periods-id-breakdowns","link_url":"","link_external":false,"previousSlug":"","category":"66d9b8948761d7005adb7554","createdAt":"2024-09-05T13:56:37.856Z","parentDoc":"66d9b8958761d7005adb7556","isBodyEmpty":true,"children":[]}]},{"_id":"66d9b8958761d7005adb7557","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"66d9b8948761d7005adb7552"},"title":"Absence Types","icon":"","type":"basic","slug":"absence-types-closed-alpha","order":2,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Absence Types (Closed Alpha)","link_url":"","link_external":false,"previousSlug":"","category":"66d9b8948761d7005adb7554","createdAt":"2024-09-05T13:56:37.793Z","mdx":{},"isBodyEmpty":true,"children":[{"_id":"66d9b8958761d7005adb7561","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66d9b8948761d7005adb7552"},"title":"Retrieves an absence type by ID.","icon":"","type":"endpoint","slug":"get_v2-absence-types-id","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-absence-types-id","link_url":"","link_external":false,"previousSlug":"","category":"66d9b8948761d7005adb7554","createdAt":"2024-09-05T13:56:37.857Z","parentDoc":"66d9b8958761d7005adb7557","isBodyEmpty":true,"children":[]},{"_id":"66d9b8958761d7005adb7562","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66d9b8948761d7005adb7552"},"title":"List absence types.","icon":"","type":"endpoint","slug":"get_v2-absence-types","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-absence-types","link_url":"","link_external":false,"previousSlug":"","category":"66d9b8948761d7005adb7554","createdAt":"2024-09-05T13:56:37.858Z","parentDoc":"66d9b8958761d7005adb7557","isBodyEmpty":true,"children":[]}]}]},{"_id":"66d9b820191cd8005b8ba713","title":"Attendances API","slug":"attendances-api","order":14,"reference":true,"project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","createdAt":"2024-09-05T13:54:40.538Z","__v":0,"pages":[{"_id":"66d9b821191cd8005b8ba714","api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"66d9b820191cd8005b8ba711"},"title":"Attendances","icon":"","type":"basic","slug":"attendances-closed-alpha","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Attendances (Closed Alpha)","link_url":"","link_external":false,"previousSlug":"","category":"66d9b820191cd8005b8ba713","createdAt":"2024-09-05T13:54:41.473Z","mdx":{},"isBodyEmpty":true,"children":[{"_id":"66d9b821191cd8005b8ba716","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66d9b820191cd8005b8ba711"},"title":"Get an attendance period.","icon":"","type":"endpoint","slug":"get_v2-attendance-periods-id","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-attendance-periods-id","link_url":"","link_external":false,"previousSlug":"","category":"66d9b820191cd8005b8ba713","createdAt":"2024-09-05T13:54:41.500Z","parentDoc":"66d9b821191cd8005b8ba714","isBodyEmpty":true,"children":[]},{"_id":"66d9b821191cd8005b8ba717","api":{"method":"delete","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66d9b820191cd8005b8ba711"},"title":"Delete an attendance period by ID.","icon":"","type":"endpoint","slug":"delete_v2-attendance-periods-id","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"delete_v2-attendance-periods-id","link_url":"","link_external":false,"previousSlug":"","category":"66d9b820191cd8005b8ba713","createdAt":"2024-09-05T13:54:41.501Z","parentDoc":"66d9b821191cd8005b8ba714","isBodyEmpty":true,"children":[]},{"_id":"66d9b821191cd8005b8ba718","api":{"method":"patch","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66d9b820191cd8005b8ba711"},"title":"Update an attendance period.","icon":"","type":"endpoint","slug":"patch_v2-attendance-periods-id","order":2,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"patch_v2-attendance-periods-id","link_url":"","link_external":false,"previousSlug":"","category":"66d9b820191cd8005b8ba713","createdAt":"2024-09-05T13:54:41.502Z","parentDoc":"66d9b821191cd8005b8ba714","isBodyEmpty":true,"children":[]},{"_id":"66d9b821191cd8005b8ba719","api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66d9b820191cd8005b8ba711"},"title":"List attendance periods.","icon":"","type":"endpoint","slug":"get_v2-attendance-periods","order":3,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-attendance-periods","link_url":"","link_external":false,"previousSlug":"","category":"66d9b820191cd8005b8ba713","createdAt":"2024-09-05T13:54:41.502Z","parentDoc":"66d9b821191cd8005b8ba714","isBodyEmpty":true,"children":[]},{"_id":"66d9b821191cd8005b8ba71a","api":{"method":"post","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"66d9b820191cd8005b8ba711"},"title":"Create an attendance period.","icon":"","type":"endpoint","slug":"post_v2-attendance-periods","order":4,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"post_v2-attendance-periods","link_url":"","link_external":false,"previousSlug":"","category":"66d9b820191cd8005b8ba713","createdAt":"2024-09-05T13:54:41.503Z","parentDoc":"66d9b821191cd8005b8ba714","isBodyEmpty":true,"children":[]}]}]},{"_id":"67c9be266828a10044ed87f9","title":"Recruiting (Beta)","slug":"recruiting-beta","order":9999,"reference":true,"project":"58bec8f49d43720f0043fdb2","version":"6527bc3eb308ad001a4f25c0","createdAt":"2025-03-06T15:24:22.948Z","__v":0,"pages":[{"_id":"67cabcdb7ee9220031862853","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"67c9be266828a10044ed87f7"},"title":"Applications","icon":"","type":"basic","slug":"applications","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Applications","link_url":"","link_external":false,"previousSlug":"","category":"67c9be266828a10044ed87f9","createdAt":"2025-03-07T09:31:07.384Z","isBodyEmpty":true,"children":[{"_id":"67cabcdb7ee9220031862855","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"67c9be266828a10044ed87f7"},"title":"List all applications.","icon":"","type":"endpoint","slug":"get_v2-recruiting-applications","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-recruiting-applications","link_url":"","link_external":false,"previousSlug":"","category":"67c9be266828a10044ed87f9","createdAt":"2025-03-07T09:31:07.412Z","parentDoc":"67cabcdb7ee9220031862853","isBodyEmpty":true,"children":[]},{"_id":"67cabcdb7ee9220031862856","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"67c9be266828a10044ed87f7"},"title":"Retrieve an application by ID.","icon":"","type":"endpoint","slug":"get_v2-recruiting-applications-id","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-recruiting-applications-id","link_url":"","link_external":false,"previousSlug":"","category":"67c9be266828a10044ed87f9","createdAt":"2025-03-07T09:31:07.413Z","parentDoc":"67cabcdb7ee9220031862853","isBodyEmpty":true,"children":[]},{"_id":"67cabcdb7ee9220031862857","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"67c9be266828a10044ed87f7"},"title":"List all application stage transitions for an application ID.","icon":"","type":"endpoint","slug":"get_v2-recruiting-applications-id-stage-transitions","order":2,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-recruiting-applications-id-stage-transitions","link_url":"","link_external":false,"previousSlug":"","category":"67c9be266828a10044ed87f9","createdAt":"2025-03-07T09:31:07.413Z","parentDoc":"67cabcdb7ee9220031862853","isBodyEmpty":true,"children":[]}]},{"_id":"67cace481b74c900454b2a99","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"67c9be266828a10044ed87f7"},"title":"Candidates","icon":"","type":"basic","slug":"candidates","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Candidates","link_url":"","link_external":false,"previousSlug":"","category":"67c9be266828a10044ed87f9","createdAt":"2025-03-07T10:45:28.854Z","isBodyEmpty":true,"children":[{"_id":"67cace481b74c900454b2a9d","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"67c9be266828a10044ed87f7"},"title":"List all candidates.","icon":"","type":"endpoint","slug":"get_v2-recruiting-candidates-1","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-recruiting-candidates","link_url":"","link_external":false,"previousSlug":"","category":"67c9be266828a10044ed87f9","createdAt":"2025-03-07T10:45:28.925Z","parentDoc":"67cace481b74c900454b2a99","isBodyEmpty":true,"children":[]},{"_id":"67cace481b74c900454b2a9e","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"67c9be266828a10044ed87f7"},"title":"Retrieve a candidate by ID.","icon":"","type":"endpoint","slug":"get_v2-recruiting-candidates-id-1","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-recruiting-candidates-id","link_url":"","link_external":false,"previousSlug":"","category":"67c9be266828a10044ed87f9","createdAt":"2025-03-07T10:45:28.926Z","parentDoc":"67cace481b74c900454b2a99","isBodyEmpty":true,"children":[]}]},{"_id":"67cace481b74c900454b2a9a","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"67c9be266828a10044ed87f7"},"title":"Jobs","icon":"","type":"basic","slug":"jobs","order":2,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Jobs","link_url":"","link_external":false,"previousSlug":"","category":"67c9be266828a10044ed87f9","createdAt":"2025-03-07T10:45:28.855Z","isBodyEmpty":true,"children":[{"_id":"67cace481b74c900454b2a9f","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"67c9be266828a10044ed87f7"},"title":"List all jobs.","icon":"","type":"endpoint","slug":"get_v2-recruiting-jobs","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-recruiting-jobs","link_url":"","link_external":false,"previousSlug":"","category":"67c9be266828a10044ed87f9","createdAt":"2025-03-07T10:45:28.926Z","parentDoc":"67cace481b74c900454b2a9a","isBodyEmpty":true,"children":[]},{"_id":"67cace481b74c900454b2aa0","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"67c9be266828a10044ed87f7"},"title":"Retrieve an job by ID.","icon":"","type":"endpoint","slug":"get_v2-recruiting-jobs-id","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-recruiting-jobs-id","link_url":"","link_external":false,"previousSlug":"","category":"67c9be266828a10044ed87f9","createdAt":"2025-03-07T10:45:28.927Z","parentDoc":"67cace481b74c900454b2a9a","isBodyEmpty":true,"children":[]}]},{"_id":"67e572b6b7fc80002ac5f9f5","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"apiSetting":"67c9be266828a10044ed87f7"},"title":"Categories","icon":"","type":"basic","slug":"categories","order":3,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"tag__Categories","link_url":"","link_external":false,"previousSlug":"","category":"67c9be266828a10044ed87f9","createdAt":"2025-03-27T15:45:58.172Z","isBodyEmpty":true,"children":[{"_id":"67e572b6b7fc80002ac5f9f7","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"67c9be266828a10044ed87f7"},"title":"List all job categories.","icon":"","type":"endpoint","slug":"get_v2-recruiting-categories","order":0,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-recruiting-categories","link_url":"","link_external":false,"previousSlug":"","category":"67c9be266828a10044ed87f9","createdAt":"2025-03-27T15:45:58.269Z","parentDoc":"67e572b6b7fc80002ac5f9f5","isBodyEmpty":true,"children":[]},{"_id":"67e572b6b7fc80002ac5f9f8","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[],"results":{"codes":[]},"apiSetting":"67c9be266828a10044ed87f7"},"title":"Retrieve a job category by its ID.","icon":"","type":"endpoint","slug":"get_v2-recruiting-categories-id","order":1,"isReference":true,"deprecated":false,"hidden":false,"sync_unique":"get_v2-recruiting-categories-id","link_url":"","link_external":false,"previousSlug":"","category":"67c9be266828a10044ed87f9","createdAt":"2025-03-27T15:45:58.269Z","parentDoc":"67e572b6b7fc80002ac5f9f5","isBodyEmpty":true,"children":[]}]}]}],"meta":{"title":"Personio Developer Hub","type":"home"},"config":{"algoliaIndex":"readme_search_v2","amplitude":{"apiKey":"dc8065a65ef83d6ad23e37aaf014fc84","enabled":true},"asset_url":"https://cdn.readme.io","domain":"readme.io","domainFull":"https://dash.readme.com","encryptedLocalStorageKey":"ekfls-2025-03-27","fullstory":{"enabled":true,"orgId":"FSV9A"},"metrics":{"billingCronEnabled":"true","dashUrl":"https://m.readme.io","defaultUrl":"https://m.readme.io","exportMaxRetries":12,"wsUrl":"wss://m.readme.io"},"proxyUrl":"https://try.readme.io","readmeRecaptchaSiteKey":"6LesVBYpAAAAAESOCHOyo2kF9SZXPVb54Nwf3i2x","releaseVersion":"5.319.0","sentry":{"dsn":"https://3bbe57a973254129bcb93e47dc0cc46f@o343074.ingest.sentry.io/2052166","enabled":true,"tracesSampleRate":0},"shMigration":{"promoVideo":"","forceWaitlist":false},"sslBaseDomain":"readmessl.com","sslGenerationService":"ssl.readmessl.com","stripePk":"pk_live_5103PML2qXbDukVh7GDAkQoR4NSuLqy8idd5xtdm9407XdPR6o3bo663C1ruEGhXJjpnb2YCpj8EU1UvQYanuCjtr00t1DRCf2a","superHub":{"newProjectsEnabled":true},"wootric":{"accountToken":"NPS-122b75a4","enabled":true}},"context":{"labs":{},"user":{},"terms":[],"variables":{"user":{},"defaults":[{"source":"security","type":"http","_id":"640201ebb4e93c007aad11f1","name":"bearerAuth","scheme":"bearer","apiSetting":"609158e7204c7e001baff965"},{"source":"security","type":"http","_id":"6797769485615d0057ede30d","name":"BearerAuth","scheme":"bearer","apiSetting":"58cd4a8450a0c12500e89bf8"}]},"project":{"_id":"58bec8f49d43720f0043fdb2","appearance":{"hide_logo":false,"categoriesAsDropdown":false,"header":{"img_size":"auto","img":[],"style":"solid","img_pos":"tl"},"html_footer":"","html_promo":"","theme":"line","main_body":{"type":"links"},"nextStepsLabel":"","showVersion":true,"typography":{"tk_key":"","typekit":false,"body":"Open+Sans:400:sans-serif","headline":"Open+Sans:400:sans-serif","tk_body":"","tk_headline":""},"link_logo_to_url":false,"logo_white":["https://files.readme.io/f26881f9dc4ad46e4ff0180ea0fcd4e6a96d7a84480e58081d733a48d70f7dfe-small-Personio_Wordmark_Black.png","f26881f9dc4ad46e4ff0180ea0fcd4e6a96d7a84480e58081d733a48d70f7dfe-small-Personio_Wordmark_Black.png",422,80,"#40404f","https://files.readme.io/9b91290183df81692fbdd5f0e2c23100865e6370f585d8a947aa7618995c73f8-Personio_Wordmark_Black.png","67ee740e7a35760018d55878"],"notheme":false,"promos":[{"extras":{"type":"html","buttonPrimary":"get-started","buttonSecondary":"reference"},"title":"","text":"","_id":"58bec8f49d43720f0043fdb3"}],"stylesheet_hub2":".hub-reference-left > div.magic-block-callout, .hub-reference-left > div.magic-block-textarea {\n margin-top: 30px;\n}\n\n \nbody {\n\tfont-family: \"Inter\",-apple-system,system-ui,BlinkMacSystemFont,\"Segoe UI\",Roboto,\"Helvetica Neue\",Arial,sans-serif !important;\n}\n\na {\n\tcolor: #000; \n font-weight: 600;\n}\n\n/*Top navbar\n#header-top {\n\theight: 80px !important;\n}\n\n#subheader-links a.active {\n\tbox-shadow: inset 0 -2px 0 #0DB5DF;\n color: #0DB5DF !important;\n font-weight: 700;\n}\n\n.theme-line header#hub-header #header-top{\n border-bottom: 1px solid #ffffff;\n}\n\n#hub-subheader-parent #hub-subheader {\n background-color: #f4f7f9;\n \tborder-bottom: 1px solid #ffffff;\n}\n*/\n\nimg.rm-Logo-img { \n\theight: 0;\n width: 0;\n padding: 0 189px 23px 0;\n \n background-image: url('https://files.readme.io/4842909267541fef0dcce0fe79f121a83b9f318f80a9c08a788cac044b7c1f69-dev_hub_white_pr.png');\n background-size: cover;\n}\n\nheader.rm-Header { \n position:sticky; top:0;\n box-shadow: none;\n -webkit-box-shadow: none;\n}\n\n.Header-topuTMpygDG4e1V .rm-SearchToggle-icon,\ndiv.rm-Header-left button.icon-menu,\ndiv.rm-Header-left div { \n color: white !important; \n}\n\ndiv.rm-Header-top {\n border:none;\n background: #000;\n}\n\ndiv.rm-Header-top a.Button { \n color: #fff;\n}\n\ndiv.rm-Header-top a.Button:active,\ndiv.rm-Header-top a.Button:hover { \n color: #fff !important;\n text-decoration: underline;\n}\n\ndiv.rm-Header-bottom { \n\tborder: none;\n\tbackground-color: white;\n}\n\n@media only screen and (max-width: 768px) {\n \na.Button.rm-Header-top-link { \n display:none;\n}\n}\na.Button.rm-Header-bottom-link {\n color: #000 !important;\n font-weight: 400;\n}\n\na.Button.rm-Header-bottom-link.active {\n background: none;\n border-bottom: 2px solid black;\n font-weight: 600;\n}\n\n/*\n\n.rm-Header-bottom-link{\n color: #7d7d8e !important;\n border-radius: 0;\n background: none !important;\n border-color: transparent !important;\n padding-bottom: 20px !important;\n padding-top: 20px !important;\n}\n.rm-Container > nav:nth-child(1){\n padding-bottom: 0px !important;\n padding-top: 0px !important;\n}\n\n.rm-Header-bottom-link:hover {\n\tbox-shadow: inset 0 -2px 0 #384248 !important;\n color: #384248 !important;\n border-radius: 0;\n background: none !important;\n border-color: transparent !important;\n}\n\n.rm-Header-bottom-link.active {\n\tbox-shadow: inset 0 -2px 0 #0DB5DF !important;\n color: #0DB5DF !important;\n font-weight: 700 !important;\n border-radius: 0;\n background: none !important;\n}\n\n.rm-Header-bottom-link.active:hover {\n\tbox-shadow: inset 0 -2px 0 #0DB5DF !important;\n color: #0DB5DF !important;\n font-weight: 700 !important;\n border-radius: 0;\n background: none !important;\n}\n.rm-LandingPage {\n max-width: var(--container-lg) !important;\n width: 100% !important;\n border: none !important\n}\n.rm-Header-bottom-link{\n color: #7d7d8e !important;\n border-radius: 0;\n background: none !important;\n border-color: transparent !important;\n padding-bottom: 20px !important;\n padding-top: 20px !important;\n}\n.rm-Container > nav:nth-child(1){\n padding-bottom: 0px !important;\n padding-top: 0px !important;\n}\n\n.rm-Header-bottom-link:hover {\n\tbox-shadow: inset 0 -2px 0 #384248 !important;\n color: #384248 !important;\n border-radius: 0;\n background: none !important;\n border-color: transparent !important;\n}\n\n.rm-Header-bottom-link.active {\n\tbox-shadow: inset 0 -2px 0 #0DB5DF !important;\n color: #0DB5DF !important;\n font-weight: 700 !important;\n border-radius: 0;\n background: none !important;\n}\n\n.rm-Header-bottom-link.active:hover {\n\tbox-shadow: inset 0 -2px 0 #0DB5DF !important;\n color: #0DB5DF !important;\n font-weight: 700 !important;\n border-radius: 0;\n background: none !important;\n}\n*/\n\n\n\n/*Main section of the landing page*/\n#main-landing-section{\n\tmargin: 15px 0;\n}\n\n#main-landing-section mark { \n border-radius: 23px;\n background: #FFFF00;\n padding: 1px 6px;\n}\n/*\n#hub-landing-top h2 {\n font-family: InterVariable,Open Sans,Helvetica Neue,Helvetica,Arial,sans-serif;\n font-size: 38px;\n font-weight: 700;\n line-height: 44px;\n color: rgb(45, 55, 71) !important;\n}\n\n.hub-landing-description p{\n\tfont-size: 18px;\n line-height: 26px;\n}\n*/\n\n.btn.btn-primary {\n\tbackground-color: #0db5df !important;\n}\n\n.btn.btn-secondary {\n\tbackground-color: #f4f7f9 !important;\n color: #555 !important;\n}\n/*\n#hub-landing-top .hub-landing-description {\n\tfont-family: InterVariable,Open Sans,Helvetica Neue,Helvetica,Arial,sans-serif;\n font-size: 16px;\n font-weight: 400;\n line-height: 20px;\n}\n*/\nh2.heading{\n\tfont-family: InterVariable,Open Sans,Helvetica Neue,Helvetica,Arial,sans-serif;\n font-size: 24px;\n font-weight: 700;\n line-height: 32px;\n color: rgb(45, 55, 71);\n}\n\nh3.heading{\n\tfont-family: InterVariable,Open Sans,Helvetica Neue,Helvetica,Arial,sans-serif;\n font-size: 18px;\n font-weight: 700;\n line-height: 24px;\n color: rgb(45, 55, 71);\n}\n\n\n/*Cards*/\n* {\n box-sizing: border-box;\n}\n\n/* Float two columns side by side */\n.column {\n float: left;\n width: 50%;\n padding: 0 30px;\n}\n\n.row-card {\n margin: 0 -30px;\n}\n\n/* Responsive columns */\n@media screen and (max-width: 600px) {\n .column {\n width: 100%;\n display: block;\n margin-bottom: 20px;\n }\n}\n\n/* Style the cards */\n.card {\n box-shadow: 0 13px 13px 0 rgba(0, 0, 0, 0.04);\n padding: 35px;\n text-align: left;\n background: rgb(255, 255, 255);\n border-radius: 8px;\n border: 1px solid #dce6ec;\n}\n\n.card h2{\n\tfont-size: 22px;\n margin: 0;\n margin-top: 0 !important;\n}\n\n.card p{\n\tfont-size: 16px;\n line-height: 24px;\n}\n\n.card a{\n\tmargin: 0;\n}\n\n\n\n/*Documentation*/\nnav#hub-sidebar ul a.active, nav#hub-sidebar ul>li.subnav-expanded>a {\n color: #555;\n background-color: #CFF0F9;\n \tfont-weight: 500;\n}\n\n.callout.callout_info{\n\tborder-left: 3px solid rgb(11, 152, 187);\n border-radius: 4px;\n}\n\n\n\n\n/*Change log*/\n.hub-changelog-list .changelog-post h3{\n\tfont-family: InterVariable,Open Sans,Helvetica Neue,Helvetica,Arial,sans-serif;\n font-size: 18px;\n font-weight: 700;\n line-height: 24px;\n color: rgb(45, 55, 71);\n}\n\n#changelog-type-icon.cl-improved, .icon-changelog-type.cl-improved {\n\tbackground-color: #0db5df; \n}\n\n#readmeLogo {\n display: none;\n}","hideTableOfContents":false,"html_body":"","html_footer_meta":"","javascript":"","logo":["https://files.readme.io/344ccf55e2da6ae08fc012392cc1b7d36c6f8806128c7cbbca6f44ffcc127cac-small-Personio_Wordmark_Black.png","344ccf55e2da6ae08fc012392cc1b7d36c6f8806128c7cbbca6f44ffcc127cac-small-Personio_Wordmark_Black.png",422,80,"#40404f","https://files.readme.io/77470beb8fc2ac2b7488b626df7b7a4bcd6187fb6349cd0945cc03f6f8ce35fa-Personio_Wordmark_Black.png","67ee742894738000710e2960"],"logo_white_use":false,"sticky":false,"body":{"style":"none"},"favicon":["https://files.readme.io/5772748b0e0ebe35eb07b2f3bf4a342b6d4bd44f5f5d692479fffaf1743ccba3-small-VersionBlack_transparent.png","5772748b0e0ebe35eb07b2f3bf4a342b6d4bd44f5f5d692479fffaf1743ccba3-small-VersionBlack_transparent.png",32,32,"#40404f","https://files.readme.io/d07b8073a2e6126e9b87c2e44d123020a0d4f1cfad9b2521f9acf2b744c00ff3-VersionBlack_transparent.png","67ee7475c48af600188a536d"],"html_head":"","html_hidelinks":false,"javascript_hub2":"","overlay":"triangles","stylesheet":"","colors":{"body_highlight":"","header_text":"","highlight":"","main":"#000000","main_alt":"","custom_login_link_color":""},"landing":true,"referenceLayout":"column","subheaderStyle":"links","childrenAsPills":false,"global_landing_page":{"html":"","redirect":""},"rdmd":{"callouts":{"useIconFont":false},"theme":{"background":"","border":"","markdownEdge":"","markdownFont":"","markdownFontSize":"","markdownLineHeight":null,"markdownRadius":"","markdownText":"","markdownTitle":"","markdownTitleFont":"","mdCodeBackground":"","mdCodeFont":"","mdCodeRadius":"","mdCodeTabs":"","mdCodeText":"","tableEdges":"","tableHead":"","tableHeadText":"","tableRow":"","tableStripe":"","tableText":"","text":"","title":""}},"splitReferenceDocs":false,"showMetricsInReference":true,"referenceSimpleMode":true,"stylesheet_hub3":"","loginLogo":[],"logo_large":false,"colorScheme":"light","changelog":{"layoutExpanded":false,"showAuthor":true,"showExactDate":false},"allowApiExplorerJsonEditor":false},"custom_domain":"developer.personio.de","childrenProjects":[],"derivedPlan":"startup","description":"Find documentation for the Personio API as well as comprehensive guides for integrating Personio into your existing landscape of tools and services.","error404":"","experiments":[],"first_page":"landing","flags":{"migrationRun":false,"allowImport":false,"allow_hub2":false,"correctnewlines":false,"swagger":false,"hideGoogleAnalytics":false,"jwt":false,"migrationSwaggerRun":false,"autoSslGeneration":true,"hub2":true,"oauth":false,"allowXFrame":false,"speedyRender":false,"cacheEnabled":true,"newApiExplorer":true,"newSearch":true,"alwaysShowDocPublishStatus":false,"cookieAuthentication":false,"directGoogleToStableVersion":false,"disableAnonForum":false,"enterprise":false,"newEditor":true,"newMarkdownBetaProgram":true,"oldMarkdown":false,"rdmdCompatibilityMode":false,"staging":false,"translation":false,"tutorials":true,"allowApiExplorerJsonEditor":false,"useReactApp":true,"newHeader":false,"referenceRedesign":false,"auth0Oauth":false,"graphql":false,"singleProjectEnterprise":false,"dashReact":false,"allowReferenceUpgrade":true,"metricsV2":true,"newEditorDash":true,"enableRealtimeExperiences":false,"reviewWorkflow":true,"star":false,"allowDarkMode":false,"forceDarkMode":false,"useReactGLP":false,"disablePasswordlessLogin":false,"personalizedDocs":false,"myDevelopers":false,"superHub":false,"developerDashboard":false,"allowReusableOTPs":false,"dashHomeRefresh":false,"owlbotAi":false,"apiV2":false,"git":{"read":false,"write":false},"superHubBeta":false,"dashQuickstart":false,"disableAutoTranslate":false,"customBlocks":false,"devDashHub":false,"disableSAMLScoping":false,"allowUnsafeCustomHtmlSuggestionsFromNonAdmins":false,"apiAccessRevoked":false,"passwordlessLogin":"default","disableSignups":false,"billingRedesignEnabled":true,"developerPortal":false,"mdx":false,"superHubDevelopment":false,"annualBillingEnabled":true,"devDashBillingRedesignEnabled":false,"enableOidc":false,"customComponents":false,"disableDiscussionSpamRecaptchaBypass":false,"developerViewUsersData":false,"changelogRssAlwaysPublic":false,"bidiSync":false,"superHubMigrationSelfServeFlow":false,"apiDesigner":false,"hideEnforceSSO":false,"localLLM":false,"superHubManageVersions":false,"gitSidebar":false,"superHubGlobalCustomBlocks":false,"childManagedBidi":false},"fullBaseUrl":"https://developer.personio.de/","git":{"migration":{"createRepository":{},"transformation":{},"migratingPages":{},"enableSuperhub":{}},"sync":{"linked_repository":{},"installationRequest":{},"connections":[]}},"glossaryTerms":[],"graphqlSchema":"","gracePeriod":{"enabled":false,"endsAt":null},"shouldGateDash":false,"healthCheck":{"provider":"","settings":{}},"intercom_secure_emailonly":false,"intercom":"","is_active":true,"integrations":{"login":{}},"internal":"","jwtExpirationTime":0,"landing_bottom":[{"type":"html","alignment":"left","html":"<section style=\" max-width: 768px; margin: 0 auto; display: flex; flex-direction: column; align-items: center;\">\n\n\n <div style=\"font-size:46px; font-weight: 800; text-align:center;line-height:1;\">Build better organizations,<br/>\n one line of code at a time</div>\n <div style=\"max-width: 60ch; margin: 48px auto 12px\">\n <p style=\"margin: 0 0 32px 0;\">\n Seamlessly integrate Personio with your existing tools and workflows\n using our powerful APIs, and build automations, scripts, and\n applications that <mark style=\"background-color: #FFFCCC; font-weight: 600;\">supercharge</mark> your HR processes.\n </p>\n <p style=\"display: flex; flex-grow: 0; \">\n <a href=\"/docs?ref=intro\" style=\"\n margin-right: 10px;\n display: flex;\n align-items: center;\n padding: 10px 18px 10px 20px;\n border-radius: 40px;\n border: 1px solid black;\n background: black;\n color: white;\n text-decoration: none;\n \">\n <svg xmlns=\"http://www.w3.org/2000/svg\" fill=\"none\" viewBox=\"0 0 24 24\" stroke-width=\"1.5\"\n stroke=\"currentColor\" style=\"height: 14px; width: 14px; margin-right: 8px; \">\n <path stroke-linecap=\"round\" stroke-linejoin=\"round\"\n d=\"M15.59 14.37a6 6 0 0 1-5.84 7.38v-4.8m5.84-2.58a14.98 14.98 0 0 0 6.16-12.12A14.98 14.98 0 0 0 9.631 8.41m5.96 5.96a14.926 14.926 0 0 1-5.841 2.58m-.119-8.54a6 6 0 0 0-7.381 5.84h4.8m2.581-5.84a14.927 14.927 0 0 0-2.58 5.84m2.699 2.7c-.103.021-.207.041-.311.06a15.09 15.09 0 0 1-2.448-2.448 14.9 14.9 0 0 1 .06-.312m-2.24 2.39a4.493 4.493 0 0 0-1.757 4.306 4.493 4.493 0 0 0 4.306-1.758M16.5 9a1.5 1.5 0 1 1-3 0 1.5 1.5 0 0 1 3 0Z\" />\n </svg>\n\n Get Started\n </a>\n <a href=\"/reference?ref=intro\" style=\"\n display: flex;\n align-items: center;\n padding: 10px 20px;\n border-radius: 40px;\n color: black;\n border: 1px solid black;\n text-decoration: none;\n \">\n <svg xmlns=\"http://www.w3.org/2000/svg\" fill=\"none\" viewBox=\"0 0 24 24\" stroke-width=\"1.5\"\n stroke=\"currentColor\" style=\"height: 14px; width: 14px; margin-right: 8px; \">\n <path stroke-linecap=\"round\" stroke-linejoin=\"round\"\n d=\"M12 6.042A8.967 8.967 0 0 0 6 3.75c-1.052 0-2.062.18-3 .512v14.25A8.987 8.987 0 0 1 6 18c2.305 0 4.408.867 6 2.292m0-14.25a8.966 8.966 0 0 1 6-2.292c1.052 0 2.062.18 3 .512v14.25A8.987 8.987 0 0 0 18 18a8.967 8.967 0 0 0-6 2.292m0-14.25v14.25\" />\n </svg>\n\n API Reference</a>\n </p>\n <div style=\"background: #EAE5FF; margin-top: 48px; padding: 24px\">\n <p style=\"font-size: 20px; margin: 0 0 9px 0; font-weight: 700\">Partners & publishers</p>\n <p style=\"margin: 0 0 9px 0;\">\n Join Personio’s marketplace and empower 10,000+ businesses with your innovative\n solutions.\n </p>\n <p style=\"margin:0\">\n <a style=\"color: black; font-weight: 700; text-decoration: none;\"\n href=\"https://support.personio.de/hc/en-us/articles/360011430518-First-Steps-Towards-a-Product-Partnership-With-Personio?ref=dev_hero\">\n <span style=\"text-decoration: underline;\">Become\n a product partner</span>\n <svg xmlns=\"http://www.w3.org/2000/svg\" fill=\"none\" viewBox=\"0 0 24 24\" stroke-width=\"1.5\"\n stroke=\"currentColor\" style=\"width: 12px; height: 12px;\">\n <path stroke-linecap=\"round\" stroke-linejoin=\"round\"\n d=\"M13.5 6H5.25A2.25 2.25 0 0 0 3 8.25v10.5A2.25 2.25 0 0 0 5.25 21h10.5A2.25 2.25 0 0 0 18 18.75V10.5m-10.5 6L21 3m0 0h-5.25M21 3v5.25\" />\n </svg>\n </a>\n </p>\n </div>\n\n</section>\n\n <!-- <div id=\"main-landing-section\">\n <div id=\"hub-landing-top\" class=\"hub-landing-buttons\">\n\t<div class=\"container\">\n\t\t<div class=\"row\" style='display: flex;'>\n \t\t<div class=\"col-12 col-md-5 col-lg-5 col-xl-5\">\n <h2>Let’s enable better organizations – <mark>together.</mark></h2>\n <div class=\"hub-landing-description\">\n <p>\n Whether you want to build an out-of-the-box integration for Personio's 8000+ customers or just for your own team, these resources will help you get started.\n \t</p>\n </div>\n <a href=\"/docs\" ui-sref=\"docs\" class=\"btn btn-lg btn-primary\" data-ol-has-click-handler=\"\"><i class=\"fa fa-rocket\"></i>Get Started\n </a>\n &nbsp;&nbsp;\n \t\t\t<a href=\"/reference\" ui-sref=\"reference\" class=\"btn btn-lg btn-secondary\" data-ol-has-click-handler=\"\"><i class=\"icon icon-reference-2\"></i><span>API Reference</span>\n </a>\n </div>\n \t<div class=\"col-12 col-md-7 col-lg-7 col-xl-7\">\n <!--\t <img src=\"https://www.personio.de/wp-content/uploads/2019/12/Integrationen-1024x571.png\"> -->\n<!-- \t</div>\n \t\t</div>\n </div>\n </div>\n</div> -->"},{"type":"html","alignment":"left","html":"<!-- <div class='row-card'>\n <div class='column'>\n <div class=\"card\">\n <h2>For partners</h2>\n <p>\n Integrate with Personio and display your app to 8000+ small and medium-sized businesses.\n </p>\n <a href=\"https://support.personio.de/hc/en-us/articles/360011430518-First-Steps-Towards-a-Product-Partnership-With-Personio\">Become a product partner</a> \n </div>\n </div>\n\t<div class='column'>\n \t<div class=\"card\">\n <h2>For customers</h2>\n <p>Automate people workflows by connecting your IT landscape to the single source of truth for employee data.</p>\n\t\t\t<a href=\"https://developer.personio.de/docs/getting-started-with-the-personio-api\">Get started with the API</a> \n\t</div>\n</div>\n</div> -->"},{"type":"text","alignment":"center","title":"Personio Webhooks are now live!","text":"We are proud to announce that Webhooks for the Person entity are now available to all Personio customers who have access to the Public API. To get started on your Webhooks journey, please navigate to https://developer.personio.de/v2.0/reference/webhooks"}],"mdxMigrationStatus":"rdmd","metrics":{"monthlyLimit":0,"thumbsEnabled":true,"planLimit":1000000,"realtime":{"dashEnabled":false,"hubEnabled":false},"monthlyPurchaseLimit":0,"meteredBilling":{}},"modules":{"docs":true,"landing":true,"suggested_edits":false,"discuss":true,"reference":true,"examples":true,"changelog":true,"custompages":false,"logs":false,"tutorials":false,"graphql":false},"name":"Personio Developer Hub","nav_names":{"discuss":"","docs":"Documentation","reference":"API Reference","changelog":"","tutorials":"","recipes":""},"oauth_url":"","onboardingCompleted":{"documentation":true,"appearance":true,"jwt":true,"api":true,"logs":true,"domain":true,"metricsSDK":false},"owlbot":{"enabled":false,"isPaying":false,"customization":{"answerLength":"long","customTone":"","defaultAnswer":"","forbiddenWords":"","tone":"neutral"},"copilot":{"enabled":false,"hasBeenUsed":false,"installedCustomPage":""}},"owner":{"id":null,"email":null,"name":null},"plan":"startup","planOverride":"","planSchedule":{"stripeScheduleId":null,"changeDate":null,"nextPlan":null},"planStatus":"active","planTrial":"startup","readmeScore":{"components":{"newDesign":{"enabled":true,"points":25},"reference":{"enabled":true,"points":50},"tryItNow":{"enabled":true,"points":35},"syncingOAS":{"enabled":true,"points":10},"customLogin":{"enabled":true,"points":25},"metrics":{"enabled":false,"points":40},"recipes":{"enabled":false,"points":15},"pageVoting":{"enabled":true,"points":1},"suggestedEdits":{"enabled":false,"points":10},"support":{"enabled":true,"points":5},"htmlLanding":{"enabled":true,"points":5},"guides":{"enabled":true,"points":10},"changelog":{"enabled":true,"points":5},"glossary":{"enabled":false,"points":1},"variables":{"enabled":true,"points":1},"integrations":{"enabled":false,"points":2}},"percentScore":62.5,"totalScore":172},"reCaptchaSiteKey":"6LcmlxEpAAAAAOueYtfm2GJ5GH3jsvZYf_6bIkr1","reference":{"alwaysUseDefaults":true,"defaultExpandResponseExample":false,"defaultExpandResponseSchema":false,"enableOAuthFlows":false},"seo":{"overwrite_title_tag":false},"stable":{"_id":"6527bc3eb308ad001a4f25c0","version":"2.0","version_clean":"2.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["6527bc3eb308ad001a4f2574","58beca30362a592f00396740","58beca4b2710c31b00414cb2","58c1db2d0de1f70f00a0b840","58c318c439b3fd0f0039ef38","58c334b02c506d0f00c1aeab","58c69a1eebb6c70f003482c9","58c6acb4ebb6c70f00348462","58cd35eebef8592f00efb455","58cd362950a0c12500e89a68","58cd362c72a4cb1900438ea7","58cd38cbd7d86d1900476413","58cd38cd51a94e3100d5bdb6","58cd38cf72a4cb1900438eea","58cd3aff72a4cb1900438f0f","58cd3da0bef8592f00efb459","58cd3da265903d3700d08363","58cd3f4265903d3700d08385","58cd3f9b50a0c12500e89b4c","58cd408265903d3700d083a8","58cd485f50a0c12500e89bd4","6527bc3eb308ad001a4f2575","58cd4aafd7d86d1900476521","6527bc3eb308ad001a4f2576","6527bc3eb308ad001a4f2577","5b27d022ba156500032234d5","5b27d2a36814190003f640ed","5b27d4b14a48b70003b371fc","5b28b87494e1f7000317f654","5b28b88636a5030003c3f672","5b28c2538b57130003e712fa","5b55dd1cb065af000305e217","5b55dd9a6bd0940003c996d3","5c34c6163365e70025b48b6f","5c374cf97267aa42020e6281","5c374d58a6af2943c3dac097","5cdbe8965c024f004b319c2b","6527bc3eb308ad001a4f2578","5d380ff13810e8003f49d587","6527bc3eb308ad001a4f2579","6527bc3eb308ad001a4f257a","615c253879b7fc0174732f0f","6376bee1127d99000316955b","63d3f5ad609d9b00316661ba","645e595f750cac094b038204","645e59841d43c500187c885b","6527bc3eb308ad001a4f257b","649b0c11964de6005f04e0d7","6527bc3eb308ad001a4f257c","6527bc3fb308ad001a4f25c2","6527bff7852f670074188446","6527d2b80618570039103154","65325081e701d900334acc0e","6538cdfaa9b625005a56d663","653bd759bcfb7a006ea777bc","653bd90bf88c1c0027301906","655cb153e417660068aeead2","6565f6b1ebea3800183fee3d","65685b78dfbc80001ca9a1c2","6571ef90cb0b810046bf4530","659fb2d670b5ae006bd7f90c","659fb2e049bc73007fe54bc0","65cf7cdc112665007358994b","65cf8191249c29006d6e9afe","65d4b2e62db206000ff6d6a9","65dc5ab25cf05f0049c63cca","65dc5b4d28676000363844cd","65dc5f4aa06c53006f84ca45","65dcb4e8b037af006f71a2d4","65dcb504d10d9c002aa58b12","65df04401bb78b006b641959","65df0455a1ebcf0021c7e6df","65df2213c85755005b88ec30","65df222600d64d000f9a8567","65f2e7493401930016929844","65f9662d4ebdd7003d959bba","65f9663f690838004b9208b6","65fbfe1df2b2bf00665f3cd6","65fc0b7c40e02e004513d1fb","65fc0bc31513cc001c8c83c5","65fc628d29396b0012bd8b65","6603da7faec4e000581c802d","66215c80b51417001e5d22cb","66215c812331fb0018ad1e1e","66215cf2ddc66b004ddd74aa","66215cf36998b600608d6208","66215d6939b32f001096f59f","66215d6ad2bf100019706d80","66215db92cac31004cef4799","66215dba45c13d001251d4e6","662f75c627c650001fe4ea62","662fdd74569144005aaa1b8d","662fdd7501b4ca005300ef2c","663341c1e0cd1e005c14bf8d","663341c29091f700423214af","6634f590c09014001ff6c14d","663df74d6e2b7a003d3b10b0","664c75e859e7480036248e1a","66a11ab16c0a50006290acb4","66a2407d1b5fa0004ac4d905","66d0a863bb7a580036f36320","66d1a4bad7abe20018cfe6dc","66d9b820191cd8005b8ba713","66d9b8948761d7005adb7554","67c595509a4e8b4d2d2f42bd","67c9be22079c0a0011dfe843","67c9be2440bab50051bbce30","67c9be25675417097d944396","67c9be266828a10044ed87f9","67c9be28241bbd004e308065","67c9be2a328d310024666a1f","67c9c94fde57a0006dae8801","67c9c951244c3e00178cebf3"],"createdAt":"2023-10-12T09:28:30.006Z","project":"58bec8f49d43720f0043fdb2","releaseDate":"2017-03-07T14:51:32.985Z","__v":2,"updatedAt":"2025-03-07T09:36:33.982Z","forked_from":"58bec8f49d43720f0043fdb5","pdfStatus":"","apiRegistries":[]},"subdomain":"personio","subpath":"","superHubWaitlist":false,"topnav":{"edited":true,"left":[],"right":[{"type":"url","url":"https://www.personio.com/partner/tech/","text":"Become a Partner"}],"bottom":[]},"trial":{"trialEndsAt":"2017-03-21T14:51:32.942Z","trialDeadlineEnabled":true},"translate":{"languages":[],"provider":"transifex","key_public":"","org_name":"","project_name":"","show_widget":false},"url":"https://www.personio.de","versions":[{"_id":"649b0c84f81290003b150171","version":"0-UNRELEASED","version_clean":"0.0.0-UNRELEASED","codename":"DO-NOT-PUBLISH-experiments","is_stable":false,"is_beta":false,"is_hidden":true,"is_deprecated":false,"categories":["649b0c84f81290003b150125","58beca30362a592f00396740","58beca4b2710c31b00414cb2","58c1db2d0de1f70f00a0b840","58c318c439b3fd0f0039ef38","58c334b02c506d0f00c1aeab","58c69a1eebb6c70f003482c9","58c6acb4ebb6c70f00348462","58cd35eebef8592f00efb455","58cd362950a0c12500e89a68","58cd362c72a4cb1900438ea7","58cd38cbd7d86d1900476413","58cd38cd51a94e3100d5bdb6","58cd38cf72a4cb1900438eea","58cd3aff72a4cb1900438f0f","58cd3da0bef8592f00efb459","58cd3da265903d3700d08363","58cd3f4265903d3700d08385","58cd3f9b50a0c12500e89b4c","58cd408265903d3700d083a8","58cd485f50a0c12500e89bd4","649b0c84f81290003b150126","58cd4aafd7d86d1900476521","649b0c84f81290003b150127","649b0c84f81290003b150128","5b27d022ba156500032234d5","5b27d2a36814190003f640ed","5b27d4b14a48b70003b371fc","5b28b87494e1f7000317f654","5b28b88636a5030003c3f672","5b28c2538b57130003e712fa","5b55dd1cb065af000305e217","5b55dd9a6bd0940003c996d3","5c34c6163365e70025b48b6f","5c374cf97267aa42020e6281","5c374d58a6af2943c3dac097","5cdbe8965c024f004b319c2b","649b0c84f81290003b150129","5d380ff13810e8003f49d587","649b0c84f81290003b15012a","649b0c84f81290003b15012b","615c253879b7fc0174732f0f","6376bee1127d99000316955b","63d3f5ad609d9b00316661ba","645e595f750cac094b038204","645e59841d43c500187c885b","649b0c84f81290003b15012c","649b0c11964de6005f04e0d7","649b0c85f81290003b150173","649c196758b306006af5e9e0","649c1da8f379e10026080982","649d8da78a0e9600580364f7","6583065db2c392006b1412fd","658306b6e5fdd7005474ab3f","658307b011e4a7007984fd7a","65830801ecb6b8001064c305","658309290f1c6c003f3f11b3","658309734b0064003a79444d","65830a22d5b662003826dd45","65830ad517bb6f004123202f","65830b53d5b662003826e1dd","65830b86530a5a002aead6a8","65830be317bb6f004123208d","65830c985bfa7d00782c1b6e","6584371a95105d004e98ebf7","658437e84ad97d003055fe4c","658438673518a80045c3783a","658438b16dd539005a952db9","658438ec6dd539005a952e06","65843b911c90ba0030d6675d","65843bf11cae46000ef05222","65843c8679a2070022b5736c","65843cd8c0cfb0003883379a","65843d46477c9f002a36951a","65843d8579a2070022b573dd"],"createdAt":"2023-06-27T16:21:24.927Z","project":"58bec8f49d43720f0043fdb2","releaseDate":"2017-03-07T14:51:32.985Z","__v":2,"updatedAt":"2023-12-21T13:28:37.411Z","forked_from":"58bec8f49d43720f0043fdb5"},{"_id":"58bec8f49d43720f0043fdb5","createdAt":"2017-03-07T14:51:32.985Z","is_beta":false,"is_deprecated":false,"project":"58bec8f49d43720f0043fdb2","categories":["58bec8f59d43720f0043fdb6","58beca30362a592f00396740","58beca4b2710c31b00414cb2","58c1db2d0de1f70f00a0b840","58c318c439b3fd0f0039ef38","58c334b02c506d0f00c1aeab","58c69a1eebb6c70f003482c9","58c6acb4ebb6c70f00348462","58cd35eebef8592f00efb455","58cd362950a0c12500e89a68","58cd362c72a4cb1900438ea7","58cd38cbd7d86d1900476413","58cd38cd51a94e3100d5bdb6","58cd38cf72a4cb1900438eea","58cd3aff72a4cb1900438f0f","58cd3da0bef8592f00efb459","58cd3da265903d3700d08363","58cd3f4265903d3700d08385","58cd3f9b50a0c12500e89b4c","58cd408265903d3700d083a8","58cd485f50a0c12500e89bd4","58cd4a8450a0c12500e89bf9","58cd4aafd7d86d1900476521","58ce970ea6027e1b00db4bed","5943ab89b03361002dff3c20","5b27d022ba156500032234d5","5b27d2a36814190003f640ed","5b27d4b14a48b70003b371fc","5b28b87494e1f7000317f654","5b28b88636a5030003c3f672","5b28c2538b57130003e712fa","5b55dd1cb065af000305e217","5b55dd9a6bd0940003c996d3","5c34c6163365e70025b48b6f","5c374cf97267aa42020e6281","5c374d58a6af2943c3dac097","5cdbe8965c024f004b319c2b","5cece58fa4dd7d0045f4e395","5d380ff13810e8003f49d587","60646e26c44914007fc12db3","609158e8204c7e001baff966","615c253879b7fc0174732f0f","6376bee1127d99000316955b","63d3f5ad609d9b00316661ba","645e595f750cac094b038204","645e59841d43c500187c885b","645e5a084bfecf13f03bbf97","649b0c11964de6005f04e0d7","649b0cc11362fb00633429b4","67239f85efa67b00103fae40"],"codename":"","is_hidden":false,"is_stable":false,"releaseDate":"2017-03-07T14:51:32.985Z","version":"1.0","version_clean":"1.0.0","__v":39,"updatedAt":"2025-03-07T09:36:00.340Z"},{"_id":"6527bc3eb308ad001a4f25c0","version":"2.0","version_clean":"2.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["6527bc3eb308ad001a4f2574","58beca30362a592f00396740","58beca4b2710c31b00414cb2","58c1db2d0de1f70f00a0b840","58c318c439b3fd0f0039ef38","58c334b02c506d0f00c1aeab","58c69a1eebb6c70f003482c9","58c6acb4ebb6c70f00348462","58cd35eebef8592f00efb455","58cd362950a0c12500e89a68","58cd362c72a4cb1900438ea7","58cd38cbd7d86d1900476413","58cd38cd51a94e3100d5bdb6","58cd38cf72a4cb1900438eea","58cd3aff72a4cb1900438f0f","58cd3da0bef8592f00efb459","58cd3da265903d3700d08363","58cd3f4265903d3700d08385","58cd3f9b50a0c12500e89b4c","58cd408265903d3700d083a8","58cd485f50a0c12500e89bd4","6527bc3eb308ad001a4f2575","58cd4aafd7d86d1900476521","6527bc3eb308ad001a4f2576","6527bc3eb308ad001a4f2577","5b27d022ba156500032234d5","5b27d2a36814190003f640ed","5b27d4b14a48b70003b371fc","5b28b87494e1f7000317f654","5b28b88636a5030003c3f672","5b28c2538b57130003e712fa","5b55dd1cb065af000305e217","5b55dd9a6bd0940003c996d3","5c34c6163365e70025b48b6f","5c374cf97267aa42020e6281","5c374d58a6af2943c3dac097","5cdbe8965c024f004b319c2b","6527bc3eb308ad001a4f2578","5d380ff13810e8003f49d587","6527bc3eb308ad001a4f2579","6527bc3eb308ad001a4f257a","615c253879b7fc0174732f0f","6376bee1127d99000316955b","63d3f5ad609d9b00316661ba","645e595f750cac094b038204","645e59841d43c500187c885b","6527bc3eb308ad001a4f257b","649b0c11964de6005f04e0d7","6527bc3eb308ad001a4f257c","6527bc3fb308ad001a4f25c2","6527bff7852f670074188446","6527d2b80618570039103154","65325081e701d900334acc0e","6538cdfaa9b625005a56d663","653bd759bcfb7a006ea777bc","653bd90bf88c1c0027301906","655cb153e417660068aeead2","6565f6b1ebea3800183fee3d","65685b78dfbc80001ca9a1c2","6571ef90cb0b810046bf4530","659fb2d670b5ae006bd7f90c","659fb2e049bc73007fe54bc0","65cf7cdc112665007358994b","65cf8191249c29006d6e9afe","65d4b2e62db206000ff6d6a9","65dc5ab25cf05f0049c63cca","65dc5b4d28676000363844cd","65dc5f4aa06c53006f84ca45","65dcb4e8b037af006f71a2d4","65dcb504d10d9c002aa58b12","65df04401bb78b006b641959","65df0455a1ebcf0021c7e6df","65df2213c85755005b88ec30","65df222600d64d000f9a8567","65f2e7493401930016929844","65f9662d4ebdd7003d959bba","65f9663f690838004b9208b6","65fbfe1df2b2bf00665f3cd6","65fc0b7c40e02e004513d1fb","65fc0bc31513cc001c8c83c5","65fc628d29396b0012bd8b65","6603da7faec4e000581c802d","66215c80b51417001e5d22cb","66215c812331fb0018ad1e1e","66215cf2ddc66b004ddd74aa","66215cf36998b600608d6208","66215d6939b32f001096f59f","66215d6ad2bf100019706d80","66215db92cac31004cef4799","66215dba45c13d001251d4e6","662f75c627c650001fe4ea62","662fdd74569144005aaa1b8d","662fdd7501b4ca005300ef2c","663341c1e0cd1e005c14bf8d","663341c29091f700423214af","6634f590c09014001ff6c14d","663df74d6e2b7a003d3b10b0","664c75e859e7480036248e1a","66a11ab16c0a50006290acb4","66a2407d1b5fa0004ac4d905","66d0a863bb7a580036f36320","66d1a4bad7abe20018cfe6dc","66d9b820191cd8005b8ba713","66d9b8948761d7005adb7554","67c595509a4e8b4d2d2f42bd","67c9be22079c0a0011dfe843","67c9be2440bab50051bbce30","67c9be25675417097d944396","67c9be266828a10044ed87f9","67c9be28241bbd004e308065","67c9be2a328d310024666a1f","67c9c94fde57a0006dae8801","67c9c951244c3e00178cebf3"],"createdAt":"2023-10-12T09:28:30.006Z","project":"58bec8f49d43720f0043fdb2","releaseDate":"2017-03-07T14:51:32.985Z","__v":2,"updatedAt":"2025-03-07T09:36:33.982Z","forked_from":"58bec8f49d43720f0043fdb5","pdfStatus":"","apiRegistries":[]}],"variableDefaults":[{"source":"security","type":"http","_id":"640201ebb4e93c007aad11f1","name":"bearerAuth","scheme":"bearer","apiSetting":"609158e7204c7e001baff965"},null,{"source":"security","type":"http","_id":"6797769485615d0057ede30d","name":"BearerAuth","scheme":"bearer","apiSetting":"58cd4a8450a0c12500e89bf8"}],"webhookEnabled":false,"isHubEditable":true},"projectStore":{"data":{"allow_crawlers":"disabled","canonical_url":null,"default_version":{"name":"2.0"},"description":"Find documentation for the Personio API as well as comprehensive guides for integrating Personio into your existing landscape of tools and services.","glossary":[],"homepage_url":"https://www.personio.de","id":"58bec8f49d43720f0043fdb2","name":"Personio Developer Hub","parent":null,"redirects":[],"sitemap":"disabled","subdomain":"personio","suggested_edits":"disabled","uri":"/projects/me","variable_defaults":[{"name":"bearerAuth","scheme":"bearer","source":"security","type":"http","id":"640201ebb4e93c007aad11f1"},{"name":"BearerAuth","scheme":"bearer","source":"security","type":"http","id":"6797769485615d0057ede30d"}],"webhooks":[],"api_designer":{"allow_editing":"enabled"},"custom_login":{"login_url":null,"logout_url":null},"features":{"custom_components":"disabled","mdx":"disabled"},"onboarding_completed":{"api":true,"appearance":true,"documentation":true,"domain":true,"jwt":true,"logs":true,"metricsSDK":false},"pages":{"not_found":null},"privacy":{"view":"public","password":null},"refactored":{"status":"disabled","migrated":"unknown"},"reference":{"api_sdk_snippets":"enabled","defaults":"always_use","json_editor":"disabled","oauth_flows":"disabled","request_history":"enabled","response_examples":"collapsed","response_schemas":"collapsed"},"seo":{"overwrite_title_tag":"disabled"},"plan":{"type":"startup","grace_period":{"enabled":false,"end_date":null},"trial":{"expired":false,"end_date":"2017-03-21T14:51:32.942Z"}},"health_check":{"provider":"none","settings":{"manual":{"status":"down","url":null},"statuspage":{"id":null}}},"integrations":{"aws":{"readme_webhook_login":{"region":null,"external_id":null,"role_arn":null,"usage_plan_id":null}},"bing":{"verify":null},"google":{"analytics":null,"site_verification":null},"heap":{"id":null},"koala":{"key":null},"localize":{"key":null},"recaptcha":{"site_key":"6LcmlxEpAAAAAOueYtfm2GJ5GH3jsvZYf_6bIkr1","secret_key":null},"segment":{"key":null,"domain":null},"typekit":{"key":null},"zendesk":{"subdomain":null},"intercom":{"app_id":null,"secure_mode":{"key":null,"email_only":false}}},"permissions":{"appearance":{"private_label":"disabled","custom_code":{"css":"enabled","html":"disabled","js":"disabled"}}},"appearance":{"brand":{"primary_color":"#000000","link_color":null,"theme":"light"},"changelog":{"layout":"collapsed","show_author":true,"show_exact_date":false},"markdown":{"callouts":{"icon_font":"emojis"}},"table_of_contents":"enabled","whats_next_label":null,"footer":{"readme_logo":"show"},"logo":{"size":"default","dark_mode":{"uri":"/images/67ee740e7a35760018d55878","url":"https://files.readme.io/f26881f9dc4ad46e4ff0180ea0fcd4e6a96d7a84480e58081d733a48d70f7dfe-small-Personio_Wordmark_Black.png","name":"f26881f9dc4ad46e4ff0180ea0fcd4e6a96d7a84480e58081d733a48d70f7dfe-small-Personio_Wordmark_Black.png","width":422,"height":80,"color":"#40404f","links":{"original_url":"https://files.readme.io/9b91290183df81692fbdd5f0e2c23100865e6370f585d8a947aa7618995c73f8-Personio_Wordmark_Black.png"}},"main":{"uri":"/images/67ee742894738000710e2960","url":"https://files.readme.io/344ccf55e2da6ae08fc012392cc1b7d36c6f8806128c7cbbca6f44ffcc127cac-small-Personio_Wordmark_Black.png","name":"344ccf55e2da6ae08fc012392cc1b7d36c6f8806128c7cbbca6f44ffcc127cac-small-Personio_Wordmark_Black.png","width":422,"height":80,"color":"#40404f","links":{"original_url":"https://files.readme.io/77470beb8fc2ac2b7488b626df7b7a4bcd6187fb6349cd0945cc03f6f8ce35fa-Personio_Wordmark_Black.png"}},"favicon":{"uri":"/images/67ee7475c48af600188a536d","url":"https://files.readme.io/5772748b0e0ebe35eb07b2f3bf4a342b6d4bd44f5f5d692479fffaf1743ccba3-small-VersionBlack_transparent.png","name":"5772748b0e0ebe35eb07b2f3bf4a342b6d4bd44f5f5d692479fffaf1743ccba3-small-VersionBlack_transparent.png","width":32,"height":32,"color":"#40404f","links":{"original_url":"https://files.readme.io/d07b8073a2e6126e9b87c2e44d123020a0d4f1cfad9b2521f9acf2b744c00ff3-VersionBlack_transparent.png"}}},"custom_code":{"css":".hub-reference-left > div.magic-block-callout, .hub-reference-left > div.magic-block-textarea {\n margin-top: 30px;\n}\n\n \nbody {\n\tfont-family: \"Inter\",-apple-system,system-ui,BlinkMacSystemFont,\"Segoe UI\",Roboto,\"Helvetica Neue\",Arial,sans-serif !important;\n}\n\na {\n\tcolor: #000; \n font-weight: 600;\n}\n\n/*Top navbar\n#header-top {\n\theight: 80px !important;\n}\n\n#subheader-links a.active {\n\tbox-shadow: inset 0 -2px 0 #0DB5DF;\n color: #0DB5DF !important;\n font-weight: 700;\n}\n\n.theme-line header#hub-header #header-top{\n border-bottom: 1px solid #ffffff;\n}\n\n#hub-subheader-parent #hub-subheader {\n background-color: #f4f7f9;\n \tborder-bottom: 1px solid #ffffff;\n}\n*/\n\nimg.rm-Logo-img { \n\theight: 0;\n width: 0;\n padding: 0 189px 23px 0;\n \n background-image: url('https://files.readme.io/4842909267541fef0dcce0fe79f121a83b9f318f80a9c08a788cac044b7c1f69-dev_hub_white_pr.png');\n background-size: cover;\n}\n\nheader.rm-Header { \n position:sticky; top:0;\n box-shadow: none;\n -webkit-box-shadow: none;\n}\n\n.Header-topuTMpygDG4e1V .rm-SearchToggle-icon,\ndiv.rm-Header-left button.icon-menu,\ndiv.rm-Header-left div { \n color: white !important; \n}\n\ndiv.rm-Header-top {\n border:none;\n background: #000;\n}\n\ndiv.rm-Header-top a.Button { \n color: #fff;\n}\n\ndiv.rm-Header-top a.Button:active,\ndiv.rm-Header-top a.Button:hover { \n color: #fff !important;\n text-decoration: underline;\n}\n\ndiv.rm-Header-bottom { \n\tborder: none;\n\tbackground-color: white;\n}\n\n@media only screen and (max-width: 768px) {\n \na.Button.rm-Header-top-link { \n display:none;\n}\n}\na.Button.rm-Header-bottom-link {\n color: #000 !important;\n font-weight: 400;\n}\n\na.Button.rm-Header-bottom-link.active {\n background: none;\n border-bottom: 2px solid black;\n font-weight: 600;\n}\n\n/*\n\n.rm-Header-bottom-link{\n color: #7d7d8e !important;\n border-radius: 0;\n background: none !important;\n border-color: transparent !important;\n padding-bottom: 20px !important;\n padding-top: 20px !important;\n}\n.rm-Container > nav:nth-child(1){\n padding-bottom: 0px !important;\n padding-top: 0px !important;\n}\n\n.rm-Header-bottom-link:hover {\n\tbox-shadow: inset 0 -2px 0 #384248 !important;\n color: #384248 !important;\n border-radius: 0;\n background: none !important;\n border-color: transparent !important;\n}\n\n.rm-Header-bottom-link.active {\n\tbox-shadow: inset 0 -2px 0 #0DB5DF !important;\n color: #0DB5DF !important;\n font-weight: 700 !important;\n border-radius: 0;\n background: none !important;\n}\n\n.rm-Header-bottom-link.active:hover {\n\tbox-shadow: inset 0 -2px 0 #0DB5DF !important;\n color: #0DB5DF !important;\n font-weight: 700 !important;\n border-radius: 0;\n background: none !important;\n}\n.rm-LandingPage {\n max-width: var(--container-lg) !important;\n width: 100% !important;\n border: none !important\n}\n.rm-Header-bottom-link{\n color: #7d7d8e !important;\n border-radius: 0;\n background: none !important;\n border-color: transparent !important;\n padding-bottom: 20px !important;\n padding-top: 20px !important;\n}\n.rm-Container > nav:nth-child(1){\n padding-bottom: 0px !important;\n padding-top: 0px !important;\n}\n\n.rm-Header-bottom-link:hover {\n\tbox-shadow: inset 0 -2px 0 #384248 !important;\n color: #384248 !important;\n border-radius: 0;\n background: none !important;\n border-color: transparent !important;\n}\n\n.rm-Header-bottom-link.active {\n\tbox-shadow: inset 0 -2px 0 #0DB5DF !important;\n color: #0DB5DF !important;\n font-weight: 700 !important;\n border-radius: 0;\n background: none !important;\n}\n\n.rm-Header-bottom-link.active:hover {\n\tbox-shadow: inset 0 -2px 0 #0DB5DF !important;\n color: #0DB5DF !important;\n font-weight: 700 !important;\n border-radius: 0;\n background: none !important;\n}\n*/\n\n\n\n/*Main section of the landing page*/\n#main-landing-section{\n\tmargin: 15px 0;\n}\n\n#main-landing-section mark { \n border-radius: 23px;\n background: #FFFF00;\n padding: 1px 6px;\n}\n/*\n#hub-landing-top h2 {\n font-family: InterVariable,Open Sans,Helvetica Neue,Helvetica,Arial,sans-serif;\n font-size: 38px;\n font-weight: 700;\n line-height: 44px;\n color: rgb(45, 55, 71) !important;\n}\n\n.hub-landing-description p{\n\tfont-size: 18px;\n line-height: 26px;\n}\n*/\n\n.btn.btn-primary {\n\tbackground-color: #0db5df !important;\n}\n\n.btn.btn-secondary {\n\tbackground-color: #f4f7f9 !important;\n color: #555 !important;\n}\n/*\n#hub-landing-top .hub-landing-description {\n\tfont-family: InterVariable,Open Sans,Helvetica Neue,Helvetica,Arial,sans-serif;\n font-size: 16px;\n font-weight: 400;\n line-height: 20px;\n}\n*/\nh2.heading{\n\tfont-family: InterVariable,Open Sans,Helvetica Neue,Helvetica,Arial,sans-serif;\n font-size: 24px;\n font-weight: 700;\n line-height: 32px;\n color: rgb(45, 55, 71);\n}\n\nh3.heading{\n\tfont-family: InterVariable,Open Sans,Helvetica Neue,Helvetica,Arial,sans-serif;\n font-size: 18px;\n font-weight: 700;\n line-height: 24px;\n color: rgb(45, 55, 71);\n}\n\n\n/*Cards*/\n* {\n box-sizing: border-box;\n}\n\n/* Float two columns side by side */\n.column {\n float: left;\n width: 50%;\n padding: 0 30px;\n}\n\n.row-card {\n margin: 0 -30px;\n}\n\n/* Responsive columns */\n@media screen and (max-width: 600px) {\n .column {\n width: 100%;\n display: block;\n margin-bottom: 20px;\n }\n}\n\n/* Style the cards */\n.card {\n box-shadow: 0 13px 13px 0 rgba(0, 0, 0, 0.04);\n padding: 35px;\n text-align: left;\n background: rgb(255, 255, 255);\n border-radius: 8px;\n border: 1px solid #dce6ec;\n}\n\n.card h2{\n\tfont-size: 22px;\n margin: 0;\n margin-top: 0 !important;\n}\n\n.card p{\n\tfont-size: 16px;\n line-height: 24px;\n}\n\n.card a{\n\tmargin: 0;\n}\n\n\n\n/*Documentation*/\nnav#hub-sidebar ul a.active, nav#hub-sidebar ul>li.subnav-expanded>a {\n color: #555;\n background-color: #CFF0F9;\n \tfont-weight: 500;\n}\n\n.callout.callout_info{\n\tborder-left: 3px solid rgb(11, 152, 187);\n border-radius: 4px;\n}\n\n\n\n\n/*Change log*/\n.hub-changelog-list .changelog-post h3{\n\tfont-family: InterVariable,Open Sans,Helvetica Neue,Helvetica,Arial,sans-serif;\n font-size: 18px;\n font-weight: 700;\n line-height: 24px;\n color: rgb(45, 55, 71);\n}\n\n#changelog-type-icon.cl-improved, .icon-changelog-type.cl-improved {\n\tbackground-color: #0db5df; \n}\n\n#readmeLogo {\n display: none;\n}","js":null,"html":{"header":null,"home_footer":null,"page_footer":null}},"header":{"type":"line","gradient_color":null,"overlay":{"fill":"auto","type":"triangles","position":"top-left","image":{"uri":null,"url":null,"name":null,"width":null,"height":null,"color":null,"links":{"original_url":null}}}},"navigation":{"first_page":"landing_page","left":[],"logo_link":"landing_page","right":[{"type":"link_url","title":"Become a Partner","url":"https://www.personio.com/partner/tech/","custom_page":null}],"sub_nav":[],"subheader_layout":"links","version":"enabled","links":{"home":{"label":"Home","visibility":"enabled"},"graphql":{"label":"GraphQL","visibility":"disabled"},"guides":{"label":"Guides","alias":"Documentation","visibility":"enabled"},"reference":{"label":"API Reference","alias":"API Reference","visibility":"enabled"},"recipes":{"label":"Recipes","alias":null,"visibility":"disabled"},"changelog":{"label":"Changelog","alias":null,"visibility":"enabled"},"discussions":{"label":"Discussions","alias":null,"visibility":"enabled"}}}},"git":{"connection":{"repository":{},"status":"inactive"}}}},"version":{"_id":"6527bc3eb308ad001a4f25c0","version":"2.0","version_clean":"2.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["6527bc3eb308ad001a4f2574","58beca30362a592f00396740","58beca4b2710c31b00414cb2","58c1db2d0de1f70f00a0b840","58c318c439b3fd0f0039ef38","58c334b02c506d0f00c1aeab","58c69a1eebb6c70f003482c9","58c6acb4ebb6c70f00348462","58cd35eebef8592f00efb455","58cd362950a0c12500e89a68","58cd362c72a4cb1900438ea7","58cd38cbd7d86d1900476413","58cd38cd51a94e3100d5bdb6","58cd38cf72a4cb1900438eea","58cd3aff72a4cb1900438f0f","58cd3da0bef8592f00efb459","58cd3da265903d3700d08363","58cd3f4265903d3700d08385","58cd3f9b50a0c12500e89b4c","58cd408265903d3700d083a8","58cd485f50a0c12500e89bd4","6527bc3eb308ad001a4f2575","58cd4aafd7d86d1900476521","6527bc3eb308ad001a4f2576","6527bc3eb308ad001a4f2577","5b27d022ba156500032234d5","5b27d2a36814190003f640ed","5b27d4b14a48b70003b371fc","5b28b87494e1f7000317f654","5b28b88636a5030003c3f672","5b28c2538b57130003e712fa","5b55dd1cb065af000305e217","5b55dd9a6bd0940003c996d3","5c34c6163365e70025b48b6f","5c374cf97267aa42020e6281","5c374d58a6af2943c3dac097","5cdbe8965c024f004b319c2b","6527bc3eb308ad001a4f2578","5d380ff13810e8003f49d587","6527bc3eb308ad001a4f2579","6527bc3eb308ad001a4f257a","615c253879b7fc0174732f0f","6376bee1127d99000316955b","63d3f5ad609d9b00316661ba","645e595f750cac094b038204","645e59841d43c500187c885b","6527bc3eb308ad001a4f257b","649b0c11964de6005f04e0d7","6527bc3eb308ad001a4f257c","6527bc3fb308ad001a4f25c2","6527bff7852f670074188446","6527d2b80618570039103154","65325081e701d900334acc0e","6538cdfaa9b625005a56d663","653bd759bcfb7a006ea777bc","653bd90bf88c1c0027301906","655cb153e417660068aeead2","6565f6b1ebea3800183fee3d","65685b78dfbc80001ca9a1c2","6571ef90cb0b810046bf4530","659fb2d670b5ae006bd7f90c","659fb2e049bc73007fe54bc0","65cf7cdc112665007358994b","65cf8191249c29006d6e9afe","65d4b2e62db206000ff6d6a9","65dc5ab25cf05f0049c63cca","65dc5b4d28676000363844cd","65dc5f4aa06c53006f84ca45","65dcb4e8b037af006f71a2d4","65dcb504d10d9c002aa58b12","65df04401bb78b006b641959","65df0455a1ebcf0021c7e6df","65df2213c85755005b88ec30","65df222600d64d000f9a8567","65f2e7493401930016929844","65f9662d4ebdd7003d959bba","65f9663f690838004b9208b6","65fbfe1df2b2bf00665f3cd6","65fc0b7c40e02e004513d1fb","65fc0bc31513cc001c8c83c5","65fc628d29396b0012bd8b65","6603da7faec4e000581c802d","66215c80b51417001e5d22cb","66215c812331fb0018ad1e1e","66215cf2ddc66b004ddd74aa","66215cf36998b600608d6208","66215d6939b32f001096f59f","66215d6ad2bf100019706d80","66215db92cac31004cef4799","66215dba45c13d001251d4e6","662f75c627c650001fe4ea62","662fdd74569144005aaa1b8d","662fdd7501b4ca005300ef2c","663341c1e0cd1e005c14bf8d","663341c29091f700423214af","6634f590c09014001ff6c14d","663df74d6e2b7a003d3b10b0","664c75e859e7480036248e1a","66a11ab16c0a50006290acb4","66a2407d1b5fa0004ac4d905","66d0a863bb7a580036f36320","66d1a4bad7abe20018cfe6dc","66d9b820191cd8005b8ba713","66d9b8948761d7005adb7554","67c595509a4e8b4d2d2f42bd","67c9be22079c0a0011dfe843","67c9be2440bab50051bbce30","67c9be25675417097d944396","67c9be266828a10044ed87f9","67c9be28241bbd004e308065","67c9be2a328d310024666a1f","67c9c94fde57a0006dae8801","67c9c951244c3e00178cebf3"],"createdAt":"2023-10-12T09:28:30.006Z","project":"58bec8f49d43720f0043fdb2","releaseDate":"2017-03-07T14:51:32.985Z","__v":2,"updatedAt":"2025-03-07T09:36:33.982Z","forked_from":"58bec8f49d43720f0043fdb5","pdfStatus":"","apiRegistries":[]}},"isDetachedProductionSite":false,"lang":"en","langFull":"Default","reqUrl":"/","version":{"_id":"6527bc3eb308ad001a4f25c0","version":"2.0","version_clean":"2.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["6527bc3eb308ad001a4f2574","58beca30362a592f00396740","58beca4b2710c31b00414cb2","58c1db2d0de1f70f00a0b840","58c318c439b3fd0f0039ef38","58c334b02c506d0f00c1aeab","58c69a1eebb6c70f003482c9","58c6acb4ebb6c70f00348462","58cd35eebef8592f00efb455","58cd362950a0c12500e89a68","58cd362c72a4cb1900438ea7","58cd38cbd7d86d1900476413","58cd38cd51a94e3100d5bdb6","58cd38cf72a4cb1900438eea","58cd3aff72a4cb1900438f0f","58cd3da0bef8592f00efb459","58cd3da265903d3700d08363","58cd3f4265903d3700d08385","58cd3f9b50a0c12500e89b4c","58cd408265903d3700d083a8","58cd485f50a0c12500e89bd4","6527bc3eb308ad001a4f2575","58cd4aafd7d86d1900476521","6527bc3eb308ad001a4f2576","6527bc3eb308ad001a4f2577","5b27d022ba156500032234d5","5b27d2a36814190003f640ed","5b27d4b14a48b70003b371fc","5b28b87494e1f7000317f654","5b28b88636a5030003c3f672","5b28c2538b57130003e712fa","5b55dd1cb065af000305e217","5b55dd9a6bd0940003c996d3","5c34c6163365e70025b48b6f","5c374cf97267aa42020e6281","5c374d58a6af2943c3dac097","5cdbe8965c024f004b319c2b","6527bc3eb308ad001a4f2578","5d380ff13810e8003f49d587","6527bc3eb308ad001a4f2579","6527bc3eb308ad001a4f257a","615c253879b7fc0174732f0f","6376bee1127d99000316955b","63d3f5ad609d9b00316661ba","645e595f750cac094b038204","645e59841d43c500187c885b","6527bc3eb308ad001a4f257b","649b0c11964de6005f04e0d7","6527bc3eb308ad001a4f257c","6527bc3fb308ad001a4f25c2","6527bff7852f670074188446","6527d2b80618570039103154","65325081e701d900334acc0e","6538cdfaa9b625005a56d663","653bd759bcfb7a006ea777bc","653bd90bf88c1c0027301906","655cb153e417660068aeead2","6565f6b1ebea3800183fee3d","65685b78dfbc80001ca9a1c2","6571ef90cb0b810046bf4530","659fb2d670b5ae006bd7f90c","659fb2e049bc73007fe54bc0","65cf7cdc112665007358994b","65cf8191249c29006d6e9afe","65d4b2e62db206000ff6d6a9","65dc5ab25cf05f0049c63cca","65dc5b4d28676000363844cd","65dc5f4aa06c53006f84ca45","65dcb4e8b037af006f71a2d4","65dcb504d10d9c002aa58b12","65df04401bb78b006b641959","65df0455a1ebcf0021c7e6df","65df2213c85755005b88ec30","65df222600d64d000f9a8567","65f2e7493401930016929844","65f9662d4ebdd7003d959bba","65f9663f690838004b9208b6","65fbfe1df2b2bf00665f3cd6","65fc0b7c40e02e004513d1fb","65fc0bc31513cc001c8c83c5","65fc628d29396b0012bd8b65","6603da7faec4e000581c802d","66215c80b51417001e5d22cb","66215c812331fb0018ad1e1e","66215cf2ddc66b004ddd74aa","66215cf36998b600608d6208","66215d6939b32f001096f59f","66215d6ad2bf100019706d80","66215db92cac31004cef4799","66215dba45c13d001251d4e6","662f75c627c650001fe4ea62","662fdd74569144005aaa1b8d","662fdd7501b4ca005300ef2c","663341c1e0cd1e005c14bf8d","663341c29091f700423214af","6634f590c09014001ff6c14d","663df74d6e2b7a003d3b10b0","664c75e859e7480036248e1a","66a11ab16c0a50006290acb4","66a2407d1b5fa0004ac4d905","66d0a863bb7a580036f36320","66d1a4bad7abe20018cfe6dc","66d9b820191cd8005b8ba713","66d9b8948761d7005adb7554","67c595509a4e8b4d2d2f42bd","67c9be22079c0a0011dfe843","67c9be2440bab50051bbce30","67c9be25675417097d944396","67c9be266828a10044ed87f9","67c9be28241bbd004e308065","67c9be2a328d310024666a1f","67c9c94fde57a0006dae8801","67c9c951244c3e00178cebf3"],"createdAt":"2023-10-12T09:28:30.006Z","project":"58bec8f49d43720f0043fdb2","releaseDate":"2017-03-07T14:51:32.985Z","__v":2,"updatedAt":"2025-03-07T09:36:33.982Z","forked_from":"58bec8f49d43720f0043fdb5","pdfStatus":"","apiRegistries":[]}}"></script></div><div id="hub-container"><div class="hub-container"><div state-container ng-attr-id="{{state.current().root !== 'docs' && 'react-app-content-container'}}"><div id="replace-view" ng-non-bindable></div></div></div></div><script>var is_hub = true; var is_hub2 = true; var is_hub_edit = true; </script><div id="ssr-end"><script id="__LOADABLE_REQUIRED_CHUNKS__" type="application/json">[6601,1126,6563,9772,4904,7449,7372,187,734,954,1167,2395,9321,3073,1008,7188,5753,2852,2249,3901,7783,1456,1666,5798,4935,4287,4201,1936,9575,1080,9852,8684,2144,9141,5948,8230,1313,1202,1343,6060,3221,7327,3859,7717,5359,3307,7356,3906,3787,2447,8063,5408,2637,1731,2616,3412,2402,678,8899,7031,2578,4793,4467,6262,3556,2705,169,2548,2183,4778,3626,7779,6794,2310,473,1376,7289,1813]</script><script id="__LOADABLE_REQUIRED_CHUNKS___ext" type="application/json">{"namedChunks":["routes-SuperHub","Header","routes-PageNotFound","Footer","core-icons-chevron-up-down-svg","routes-Doc","core-icons-arrow-right-svg","Editor","core-icons-x-circle-svg","core-icons-suggested-edits-svg","routes-Changelog","Post","routes-Reference","core-icons-alert-circle-svg","core-icons-more-vertical-svg","core-icons-lock-svg","core-icons-search-svg","core-icons-custom-pages-svg","core-icons-chevron-down-svg","routes-SuperHub-Routes","RMDX","routes-Landing","routes-CustomPage","CustomPage","core-icons-arrow-up-right-svg","routes-Discuss","List","core-icons-trending-up-svg","core-icons-callout-info-svg","Page","core-icons-webhook-svg","New","core-icons-message-circle-svg","core-icons-eye-off-svg","core-icons-star-svg","routes-Tutorials","SuperHub-CustomPage","core-icons-key-svg","core-icons-chevron-right-svg","core-icons-plus-svg","core-icons-folder-plus-svg","core-icons-file-svg","core-icons-eye-svg","core-icons-book-svg","core-icons-gauge-circle-svg","core-icons-code-svg","core-icons-upload-svg","core-icons-share-2-svg","core-icons-edit-2-svg","core-icons-inbox-svg","core-icons-unlock-svg","core-graphics-json-svg"]}</script> <script async data-chunk="main" src="https://cdn.readme.io/public/hub/web/main.9223d0842ac0410bafac.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/6601.cef2fa12a9b5e2b9df03.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/1126.9d43ffa1039df16a8271.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/6563.fbd3d15eee3b5e94f665.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/9772.89a3e895d3051e33cd73.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/4904.1067704c85da57778e22.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/7449.dae0332305a8704415a6.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/7372.fbd27ab77e6e47de9931.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/187.23cea47109f7f88417f6.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/734.2949e3d7010fa5c21ffd.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/954.53ce7f86793664155f78.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/1167.a6c63c62c8690225da20.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/2395.771431a607874f268eb2.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/9321.7bab74274e71e18bb347.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/3073.ef6aff2d0ae6023765f1.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/1008.a1d50b1feee374345b35.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/7188.f444adf64944d115c52b.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/5753.72c5d7402efc1cfa5881.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/routes-SuperHub.b9f93ce0513a54980863.js"></script> <script async data-chunk="Header" src="https://cdn.readme.io/public/hub/web/2249.08687f22f6d6de29577d.js"></script> <script async data-chunk="Header" src="https://cdn.readme.io/public/hub/web/3901.9a23139e8c32bd6a1186.js"></script> <script async data-chunk="Header" src="https://cdn.readme.io/public/hub/web/7783.54e7cbd61e710313e1e0.js"></script> <script async data-chunk="Header" src="https://cdn.readme.io/public/hub/web/Header.415a3e3f42422a2546f5.js"></script> <script async data-chunk="routes-PageNotFound" src="https://cdn.readme.io/public/hub/web/routes-PageNotFound.e4a4a4dbb41ce1f8c60f.js"></script> <script async data-chunk="Footer" src="https://cdn.readme.io/public/hub/web/Footer.732d39065ba473dca3be.js"></script> <script async data-chunk="core-icons-chevron-up-down-svg" src="https://cdn.readme.io/public/hub/web/core-icons-chevron-up-down-svg.6aae957df71e6f4c5e24.js"></script> <script async data-chunk="routes-Doc" src="https://cdn.readme.io/public/hub/web/4287.916cdd386055d2c5d238.js"></script> <script async data-chunk="routes-Doc" src="https://cdn.readme.io/public/hub/web/4201.9726bbf672400e046cc2.js"></script> <script async data-chunk="routes-Doc" src="https://cdn.readme.io/public/hub/web/routes-Doc.ab23d1cf8ea817ed6084.js"></script> <script async data-chunk="core-icons-arrow-right-svg" src="https://cdn.readme.io/public/hub/web/core-icons-arrow-right-svg.eadb74658f93b4e7d75f.js"></script> <script async data-chunk="Editor" src="https://cdn.readme.io/public/hub/web/Editor.fcff689c44b953a512d6.js"></script> <script async data-chunk="core-icons-x-circle-svg" src="https://cdn.readme.io/public/hub/web/core-icons-x-circle-svg.abc0e0ea5b7f9dff667c.js"></script> <script async data-chunk="core-icons-suggested-edits-svg" src="https://cdn.readme.io/public/hub/web/core-icons-suggested-edits-svg.8d2d8ac2fd22ded9238d.js"></script> <script async data-chunk="routes-Changelog" src="https://cdn.readme.io/public/hub/web/routes-Changelog.05be16260f5ffacc35a3.js"></script> <script async data-chunk="Post" src="https://cdn.readme.io/public/hub/web/Post.0ba0ba3778e78d8254e8.js"></script> <script async data-chunk="routes-Reference" src="https://cdn.readme.io/public/hub/web/5948.a51402657e2eb40ab43b.js"></script> <script async data-chunk="routes-Reference" src="https://cdn.readme.io/public/hub/web/8230.6a96ce7f90d7aee9b636.js"></script> <script async data-chunk="routes-Reference" src="https://cdn.readme.io/public/hub/web/routes-Reference.a6b1c6bee69d46fd161f.js"></script> <script async data-chunk="core-icons-alert-circle-svg" src="https://cdn.readme.io/public/hub/web/core-icons-alert-circle-svg.4cee8264c97045599b56.js"></script> <script async data-chunk="core-icons-more-vertical-svg" src="https://cdn.readme.io/public/hub/web/core-icons-more-vertical-svg.4822b3f831e11095980d.js"></script> <script async data-chunk="core-icons-lock-svg" src="https://cdn.readme.io/public/hub/web/core-icons-lock-svg.70942d3ee6bad6267696.js"></script> <script async data-chunk="core-icons-search-svg" src="https://cdn.readme.io/public/hub/web/core-icons-search-svg.ad9cac962958d30983a7.js"></script> <script async data-chunk="core-icons-custom-pages-svg" src="https://cdn.readme.io/public/hub/web/core-icons-custom-pages-svg.444e514638d9afbec182.js"></script> <script async data-chunk="core-icons-chevron-down-svg" src="https://cdn.readme.io/public/hub/web/core-icons-chevron-down-svg.e20b84e9871bd73d1b8c.js"></script> <script async data-chunk="routes-SuperHub-Routes" src="https://cdn.readme.io/public/hub/web/7717.c3f46aef4dac129abcfb.js"></script> <script async data-chunk="routes-SuperHub-Routes" src="https://cdn.readme.io/public/hub/web/5359.fb0c48929b1827a8a2b2.js"></script> <script async data-chunk="routes-SuperHub-Routes" src="https://cdn.readme.io/public/hub/web/routes-SuperHub-Routes.b64fd1d3a15e09bf2b91.js"></script> <script async data-chunk="RMDX" src="https://cdn.readme.io/public/hub/web/RMDX.6966846032c03969e44f.js"></script> <script async data-chunk="routes-Landing" src="https://cdn.readme.io/public/hub/web/3906.b84848dda7e7f59abf47.js"></script> <script async data-chunk="routes-Landing" src="https://cdn.readme.io/public/hub/web/routes-Landing.43a15229736801911d5a.js"></script> <script async data-chunk="routes-CustomPage" src="https://cdn.readme.io/public/hub/web/CustomPage.29543915f3e70fa960d7.js"></script> <script async data-chunk="core-icons-arrow-up-right-svg" src="https://cdn.readme.io/public/hub/web/core-icons-arrow-up-right-svg.8ec73f7e322d79a2695b.js"></script> <script async data-chunk="routes-Discuss" src="https://cdn.readme.io/public/hub/web/routes-Discuss.9a682a77c9083927aeaf.js"></script> <script async data-chunk="List" src="https://cdn.readme.io/public/hub/web/2637.d47bf77a75f266a70e80.js"></script> <script async data-chunk="List" src="https://cdn.readme.io/public/hub/web/List.b1dd4485529aa4a7aa11.js"></script> <script async data-chunk="core-icons-trending-up-svg" src="https://cdn.readme.io/public/hub/web/core-icons-trending-up-svg.0dd920b0698e57f75afa.js"></script> <script async data-chunk="core-icons-callout-info-svg" src="https://cdn.readme.io/public/hub/web/core-icons-callout-info-svg.79b14e8568c9cecbc827.js"></script> <script async data-chunk="Page" src="https://cdn.readme.io/public/hub/web/Page.6d18db72aa3774dd903a.js"></script> <script async data-chunk="core-icons-webhook-svg" src="https://cdn.readme.io/public/hub/web/core-icons-webhook-svg.fe540ea1c09e1c0e0247.js"></script> <script async data-chunk="New" src="https://cdn.readme.io/public/hub/web/New.19db37c76f3b9d17353d.js"></script> <script async data-chunk="core-icons-message-circle-svg" src="https://cdn.readme.io/public/hub/web/core-icons-message-circle-svg.1e24c2d2eb4f9a6ede5d.js"></script> <script async data-chunk="core-icons-eye-off-svg" src="https://cdn.readme.io/public/hub/web/core-icons-eye-off-svg.b2b8b241b4b324dfd9c1.js"></script> <script async data-chunk="core-icons-star-svg" src="https://cdn.readme.io/public/hub/web/core-icons-star-svg.b834e1612cb2af1e174e.js"></script> <script async data-chunk="routes-Tutorials" src="https://cdn.readme.io/public/hub/web/routes-Tutorials.c83f9bb228d60f5f7f6b.js"></script> <script async data-chunk="SuperHub-CustomPage" src="https://cdn.readme.io/public/hub/web/SuperHub-CustomPage.edef7b501475b233c5a2.js"></script> <script async data-chunk="core-icons-key-svg" src="https://cdn.readme.io/public/hub/web/core-icons-key-svg.71e09670b926900508b8.js"></script> <script async data-chunk="core-icons-chevron-right-svg" src="https://cdn.readme.io/public/hub/web/core-icons-chevron-right-svg.34d126524d8ea236d174.js"></script> <script async data-chunk="core-icons-plus-svg" src="https://cdn.readme.io/public/hub/web/core-icons-plus-svg.a49fb76ac2661b5e1c7e.js"></script> <script async data-chunk="core-icons-folder-plus-svg" src="https://cdn.readme.io/public/hub/web/core-icons-folder-plus-svg.2c200438e59611867262.js"></script> <script async data-chunk="core-icons-file-svg" src="https://cdn.readme.io/public/hub/web/core-icons-file-svg.24d3e20044ef331cf0d2.js"></script> <script async data-chunk="core-icons-eye-svg" src="https://cdn.readme.io/public/hub/web/core-icons-eye-svg.b2103692a3c209893efe.js"></script> <script async data-chunk="core-icons-book-svg" src="https://cdn.readme.io/public/hub/web/core-icons-book-svg.556c5a2abddd44b2284c.js"></script> <script async data-chunk="core-icons-gauge-circle-svg" src="https://cdn.readme.io/public/hub/web/core-icons-gauge-circle-svg.fff25782546fef314a09.js"></script> <script async data-chunk="core-icons-code-svg" src="https://cdn.readme.io/public/hub/web/core-icons-code-svg.d29a4cf99a7105e13528.js"></script> <script async data-chunk="core-icons-upload-svg" src="https://cdn.readme.io/public/hub/web/core-icons-upload-svg.4d60b51fd8b6157bfc91.js"></script> <script async data-chunk="core-icons-share-2-svg" src="https://cdn.readme.io/public/hub/web/core-icons-share-2-svg.cc960c8f03a86e1d8def.js"></script> <script async data-chunk="core-icons-edit-2-svg" src="https://cdn.readme.io/public/hub/web/core-icons-edit-2-svg.a658c6ae7d1bbe84c98a.js"></script> <script async data-chunk="core-icons-inbox-svg" src="https://cdn.readme.io/public/hub/web/core-icons-inbox-svg.01c2ecb759e417a98bb8.js"></script> <script async data-chunk="core-icons-unlock-svg" src="https://cdn.readme.io/public/hub/web/core-icons-unlock-svg.d27591cc9e0be731e26d.js"></script></div><script id="hub-me" type="application/json" data-json="{"loggedIn":false,"search":{"app":"T28YKFATPY","token":"NTVhM2ExMjA5MjZlMzk1ZThjYTkzZmQzMjEyZmFlNGNlM2Q0OGM0OTBhYjE1NTMxYmM1NTA3ZTZjMmFkZGFkNHRhZ0ZpbHRlcnM9KHByb2plY3Q6NThiZWM4ZjQ5ZDQzNzIwZjAwNDNmZGIyKSwodmVyc2lvbjpub25lLHZlcnNpb246NjUyN2JjM2ViMzA4YWQwMDFhNGYyNWMwKSwoaGlkZGVuOm5vbmUsaGlkZGVuOmZhbHNlKSwoaW5kZXg6Q3VzdG9tUGFnZSxpbmRleDpQYWdlLGluZGV4OkRpc2N1c3MsaW5kZXg6QmxvZyk=","filters":"tagFilters=(project:58bec8f49d43720f0043fdb2),(version:none,version:6527bc3eb308ad001a4f25c0),(hidden:none,hidden:false),(index:CustomPage,index:Page,index:Discuss,index:Blog)","metaData":[{"modules":{"docs":true,"landing":true,"suggested_edits":false,"discuss":true,"reference":true,"examples":true,"changelog":true,"custompages":false,"logs":false,"tutorials":false,"graphql":false},"id":"58bec8f49d43720f0043fdb2","name":"Personio Developer Hub","subdomain":"personio","subpath":"","nav_names":{"discuss":"","docs":"Documentation","reference":"API Reference","changelog":"","tutorials":"","recipes":""}}]}}"></script><script id="readme-data-baseUrl" type="application/json" data-json=""/""></script></body></html>