[{"data":1,"prerenderedAt":970},["ShallowReactive",2],{"announcements":3,"blog-/blog/public-api-and-webhooks":166,"blog-related-/blog/public-api-and-webhooks":345},[4,28,46,64,82,98,114,130,148],{"id":5,"title":6,"active":7,"body":8,"description":14,"extension":19,"link":20,"linkText":21,"meta":22,"navigation":7,"order":23,"path":24,"seo":25,"stem":26,"__hash__":27},"announcements/announcements/ios-app-launch.md","The BookYourPTO iPhone app is here — leave, approvals & expenses on the go. Android coming soon",true,{"type":9,"value":10,"toc":15},"minimark",[11],[12,13,14],"p",{},"The BookYourPTO mobile app is now on the App Store for iPhone. Book leave, approve requests, and claim expenses from anywhere. Android coming soon.",{"title":16,"searchDepth":17,"depth":17,"links":18},"",2,[],"md","/mobile-app","Get the app",{},13,"/announcements/ios-app-launch",{"title":6,"description":14},"announcements/ios-app-launch","3qzUfXAJGPpl9sqLZf2eXpxXxhWkZ3n1BDP0fapqL9c",{"id":29,"title":30,"active":7,"body":31,"description":35,"extension":19,"link":38,"linkText":39,"meta":40,"navigation":7,"order":41,"path":42,"seo":43,"stem":44,"__hash__":45},"announcements/announcements/data-import.md","Move your team over from 48 HR and payroll platforms — employees, leave history and departments",{"type":9,"value":32,"toc":36},[33],[12,34,35],{},"Data Import & Migration is live. Upload a CSV or Excel export from your current HR or payroll system and BookYourPTO reads the column headers, works out which of 48 platforms it came from, and maps the fields for you — with 63 built-in templates covering everything from BambooHR, Rippling and Workday to Collage HR, Folks HR, Payworks and Wagepoint. Nothing is written until you approve the preview, and a completed import can be rolled back for 72 hours. BambooHR, Timetastic, Employment Hero and Zoho People can be connected directly over their APIs, so there is no file to export at all. Settings → Data Import, for administrators and executives, on every plan.",{"title":16,"searchDepth":17,"depth":17,"links":37},[],"/switch-from","See the platforms",{},14,"/announcements/data-import",{"title":30,"description":35},"announcements/data-import","MvYRLBetKwuvH2CJd2LvSm2chpmyLpInw_paM6_39lY",{"id":47,"title":48,"active":7,"body":49,"description":53,"extension":19,"link":56,"linkText":57,"meta":58,"navigation":7,"order":59,"path":60,"seo":61,"stem":62,"__hash__":63},"announcements/announcements/review-cycles.md","Review cycles that run themselves — anniversary or fixed dates, reminders, notes and the signed form in one place",{"type":9,"value":50,"toc":54},[51],[12,52,53],{},"Review cycles now do the work. Set one to fall on each person's own hire-date anniversary or across a fixed company window, scope it to everyone, a department or named people, and it tracks the date for each employee and chases the right people as it approaches — the department head, administrators and executives, or the employee's manager where a department has no head, each emailed once however many of those they are. Reminders default to fourteen days and three days out and are yours to change. On a profile, the Reviews tab shows what is coming up and what has already happened, a review can be marked complete, and notes carry a visibility level — Employee and above, Department Head and above, or Administrator and Executive only — so a note is kept from the employee, or from their department head as well, without maintaining a list of names. A new Review mode on the upload page sends the signed form itself: choose the cycle, the file, the people who sign and which of them is being reviewed, and the document opens from that person's Performance tab afterwards. The employee it is about owns it whether they sign first or countersign after their manager.",{"title":16,"searchDepth":17,"depth":17,"links":55},[],"/features#performance","See performance",{},15,"/announcements/review-cycles",{"title":48,"description":53},"announcements/review-cycles","UI4uhTFm26-dfu_MknZSaKWT4ps3qQqSub0hB5MLNdU",{"id":65,"title":66,"active":7,"body":67,"description":71,"extension":19,"link":74,"linkText":75,"meta":76,"navigation":7,"order":77,"path":78,"seo":79,"stem":80,"__hash__":81},"announcements/announcements/home-page.md","A home page that opens on what needs you — role-aware cards you can add, remove and rearrange",{"type":9,"value":68,"toc":72},[69],[12,70,71],{},"Signing in now lands on Home, a board of cards that answers one question first: what is waiting on you. Documents to sign, assessments you owe someone, tasks past their date and requests routed to you for a decision each get a card that links straight to the page where you act on it, and the card that lists what others are blocked on cannot be switched off. Alongside it sits your own record — leave balances, hours logged today, your next one-to-one, and a line each for goals, training, benefits, certifications and equipment — and what is happening around you, from who is away today to birthdays and work anniversaries. Managers additionally see their people and any onboarding still running; administrators and executives see headcount, joiners and leavers, review-cycle progress and what needs attention across the organization. Every card obeys the permissions and privacy settings already configured: with other departments hidden, people see only their own, and private leave types stay private. The board is yours to arrange — drag cards into the order you want, remove the ones you do not, and add optional ones such as company holidays, workforce mix, length of service or profile completeness from the tray. Your layout is stored on your account rather than in the browser, so it follows you to another device, and arranging it changes only what you see.",{"title":16,"searchDepth":17,"depth":17,"links":73},[],"/features","See features",{},16,"/announcements/home-page",{"title":66,"description":71},"announcements/home-page","WV7nAzSgeff8xq63MYSyyNUWfHyC4WegQVzJPo6pjwA",{"id":83,"title":84,"active":7,"body":85,"description":89,"extension":19,"link":74,"linkText":75,"meta":92,"navigation":7,"order":93,"path":94,"seo":95,"stem":96,"__hash__":97},"announcements/announcements/org-chart-reports-to.md","An org chart drawn from Reports To — and downloadable as PNG, PDF or a .csv for Visio and Lucidchart",{"type":9,"value":86,"toc":90},[87],[12,88,89],{},"The org chart is now built from the Reports To field and from nothing else. It used to infer reporting lines from roles, handing department heads to administrators in turn, so the lines it drew could be invented; now every line is one somebody recorded. An executive who reports to a founder or a board appears beneath them, anyone who reports to nobody sits at the top, and a person whose manager has been deactivated, who is recorded as their own manager, or who is caught in a reporting loop surfaces at the top rather than vanishing, so the record that needs fixing is visible. Export offers a PNG of the chart as drawn, the same image as a PDF, and a .csv shaped for Visio, for Lucidchart, or unformatted for a spreadsheet — all built from the same field, so a download and the chart always agree. Who can download is set separately from who can browse, under Download Access in Company Directory settings; somebody who cannot view the chart can never download it, and every download, in every format, is recorded in the audit log.",{"title":16,"searchDepth":17,"depth":17,"links":91},[],{},17,"/announcements/org-chart-reports-to",{"title":84,"description":89},"announcements/org-chart-reports-to","lDhWlPTbw2R3tIDNwVFrARNTWd0q0yBcbAoG_1fozUo",{"id":99,"title":100,"active":7,"body":101,"description":105,"extension":19,"link":74,"linkText":75,"meta":108,"navigation":7,"order":109,"path":110,"seo":111,"stem":112,"__hash__":113},"announcements/announcements/document-owner.md","Choose whose document it is when you send one for signature",{"type":9,"value":102,"toc":106},[103],[12,104,105],{},"A document sent to several people is filed under one of them, and until now that was simply whoever was added first. A salary letter signed by a manager and then the employee therefore landed in the manager's file. Sending a document to more than one person now asks whose document it is, the same question a review form already asks about the person being reviewed, and it is filed under that person whatever order the signatures are collected in. Everyone else still signs it and finds it in their own documents. The My Documents card on Home now counts every document you find in your folder, including the ones you sign alongside someone else.",{"title":16,"searchDepth":17,"depth":17,"links":107},[],{},18,"/announcements/document-owner",{"title":100,"description":105},"announcements/document-owner","_Cq3hJJ4LHxH5DoZUR7vrgXKJQG08fdG3FHSRpPlwP0",{"id":115,"title":116,"active":7,"body":117,"description":121,"extension":19,"link":74,"linkText":75,"meta":124,"navigation":7,"order":125,"path":126,"seo":127,"stem":128,"__hash__":129},"announcements/announcements/reports-details-and-smoother-pages.md","Reports open the detail you clicked, and pages stay still",{"type":9,"value":118,"toc":122},[119],[12,120,121],{},"Clicking a row in the Leave, Time or Scheduling report now opens that leave request, time entry or shift in a read-only panel beside the report, with a link to where it is reviewed or edited, so you no longer lose your place. Report date ranges follow your own calendar rather than the server's, the Time report opens on the last 30 days instead of an empty year, and report CSV files keep notes and reasons as plain text in any spreadsheet. Across the app, switching tabs no longer jumps the page, paging a list brings the next page into view, and confirmations and error messages now appear on screen when you save, approve or export.",{"title":16,"searchDepth":17,"depth":17,"links":123},[],{},19,"/announcements/reports-details-and-smoother-pages",{"title":116,"description":121},"announcements/reports-details-and-smoother-pages","CaYjA92fiC1V9prglnznYDQKVtdYJSWl2Kp1kYDckC8",{"id":131,"title":132,"active":7,"body":133,"description":137,"extension":19,"link":140,"linkText":141,"meta":142,"navigation":7,"order":143,"path":144,"seo":145,"stem":146,"__hash__":147},"announcements/announcements/expense-claim-redesign.md","Expense claims, redesigned",{"type":9,"value":134,"toc":138},[135],[12,136,137],{},"An expense claim now opens on a single header with a status stamp saying where it stands, its details in one panel, and the balance due beside the actions. Purchases, per diem and travel are tables with a totals row, per diem shows one row per day, items open in a panel beside the claim, and receipts preview on hover. On the claims list, a Columns menu lets you show or hide any column, and your choice is remembered. Trip dates also no longer show a day early west of UTC.",{"title":16,"searchDepth":17,"depth":17,"links":139},[],"/expenses","See expenses",{},20,"/announcements/expense-claim-redesign",{"title":132,"description":137},"announcements/expense-claim-redesign","n91G7jkYNzcDLQaXH-QelEauU-0tqsZ05IaOT0-u1-k",{"id":149,"title":150,"active":7,"body":151,"description":155,"extension":19,"link":158,"linkText":159,"meta":160,"navigation":7,"order":161,"path":162,"seo":163,"stem":164,"__hash__":165},"announcements/announcements/public-api-and-webhooks.md","A public REST API and signed webhooks, on every paid plan",{"type":9,"value":152,"toc":156},[153],[12,154,155],{},"BookYourPTO now has a public REST API and outbound webhooks. Read people, departments, leave, time entries, timesheets, projects and expense reports from your own scripts, add and update people, book and cancel leave, decide requests, and have leave, people, time, expense and document events pushed to your HTTPS endpoint as they happen — ready for HRIS sync, payroll export, leave dashboards, and integration platforms such as Zapier, Make and Workato through their webhook and HTTP steps. Every token acts as a real person in your organization and never sees more than they can in the app, with required expiry, scopes, optional IP allowlists and rate limits; every webhook is signed with the Standard Webhooks scheme, and every change made through the API is written to the audit log. Included on Pro, Business and Enterprise, off until an executive switches it on in Settings → API.",{"title":16,"searchDepth":17,"depth":17,"links":157},[],"/blog/public-api-and-webhooks","Read the announcement",{},21,"/announcements/public-api-and-webhooks",{"title":150,"description":155},"announcements/public-api-and-webhooks","G6PRPGX0EzKXD6F2BASJVCTUpv8I7mOvMdLbdZ3CDc4",{"id":167,"title":168,"author":169,"body":170,"date":332,"description":333,"extension":19,"image":334,"meta":335,"navigation":7,"path":158,"readTime":336,"seo":337,"stem":338,"tags":339,"__hash__":344},"blog/blog/public-api-and-webhooks.md","Connect BookYourPTO to Your Own Systems: A Public REST API and Signed Webhooks","AnHourTec Team",{"type":9,"value":171,"toc":325},[172,177,180,188,192,195,229,232,236,239,246,250,253,303,307,314],[173,174,176],"h2",{"id":175},"why-an-api-and-why-now","Why an API, and why now",[12,178,179],{},"Most teams that run leave, time and expenses in BookYourPTO also run something else: a payroll provider, an HRIS, a finance system, a dashboard somebody built in a spreadsheet. Until now, the only way to move data between them was an export, a download and an upload — repeated every pay period, by hand.",[12,181,182,183,187],{},"BookYourPTO now has a public REST API and outbound webhooks. Your own scripts and tools can read and write your HR data directly, and your systems can be told the moment something changes instead of asking every few minutes. Both are included on the ",[184,185,186],"strong",{},"Pro, Business and Enterprise"," plans. They are off until an executive in your organization switches them on.",[173,189,191],{"id":190},"what-you-can-build-with-it","What you can build with it",[12,193,194],{},"A few of the jobs the API is shaped for:",[196,197,198,205,211,217,223],"ul",{},[199,200,201,204],"li",{},[184,202,203],{},"HRIS and directory sync."," Read people, departments and teams, and create or update people from the system that owns your employee records.",[199,206,207,210],{},[184,208,209],{},"Payroll export."," Pull approved time entries, finalized timesheets, leave and leave balances for a pay period, in plain JSON, instead of assembling a spreadsheet.",[199,212,213,216],{},[184,214,215],{},"Leave dashboards."," Feed who is away, for which leave type, into a wall display, an intranet page or a BI tool — with public holidays and locked dates alongside.",[199,218,219,222],{},[184,220,221],{},"Approvals from where people already work."," Approve or reject leave requests, time entries and expense reports from your own tooling, under the same rules as the app.",[199,224,225,228],{},[184,226,227],{},"Event-driven automations."," Integration platforms such as Zapier, Make and Workato can receive webhooks and call REST APIs through their webhook and HTTP steps, so a leave approval, a new starter or a paid expense report can start a workflow elsewhere.",[12,230,231],{},"The API covers people, departments, teams, leave types, leave requests and balances, holidays, time entries, timesheets, projects and clients, schedules, expense reports, document records, onboarding, and per-person records such as training, certifications, assets and goals. A few things are deliberately left out: signing a document is a legal act tied to a person, and clocking in depends on the device's location, so neither is available through the API.",[173,233,235],{"id":234},"webhooks-be-told-rather-than-ask","Webhooks: be told, rather than ask",[12,237,238],{},"Polling an API every few minutes is wasteful and still late. A webhook endpoint receives an HTTPS request when something happens. Events cover the life of a leave request (requested, approved, rejected, updated, cancellation requested, cancelled), people (added, updated, deactivated, reactivated), departments, time entries and finalized timesheets, expense reports through to paid, and signed or declined documents.",[12,240,241,242,245],{},"Each delivery carries a unique event id that stays the same across retries, so your receiver can ignore a duplicate. A receiver that is down or returns an error is retried on a schedule that backs off over roughly two days, and every attempt is visible in a delivery log, where a failed delivery can be sent again. A ",[184,243,244],{},"Send test event"," button lets you check a new endpoint before relying on it.",[173,247,249],{"id":248},"the-security-model-in-plain-words","The security model, in plain words",[12,251,252],{},"An API is a second door into the same data, so it has to be held to the same rules as the first. These are the ones that matter:",[196,254,255,261,267,273,279,285,291,297],{},[199,256,257,260],{},[184,258,259],{},"A token acts as a person."," Every token belongs to someone in your organization and sees exactly what that person could see in the app — computed by the same permission checks the app uses, not a copy of them. An employee's token sees what that employee sees. A department head's token stays within their department.",[199,262,263,266],{},[184,264,265],{},"It follows that person."," If its owner is deactivated, offboarded, or moved to a role that may not hold tokens, the token stops working on the very next request.",[199,268,269,272],{},[184,270,271],{},"Scopes limit it further."," A token is created with only the permissions it needs — read the directory, read leave, approve time entries — and can never hold a scope above its owner's role. The most sensitive fields, such as personal details and compensation, need their own scopes and are recorded every time they are read.",[199,274,275,278],{},[184,276,277],{},"Every token expires."," There is no \"never\". Your organization sets the longest lifetime allowed, and the owner is emailed a week before a token runs out. A token can be rotated with a short overlap so an integration does not drop, and revoked at any time.",[199,280,281,284],{},[184,282,283],{},"IP allowlists."," A token can be restricted to the addresses or ranges your servers actually call from.",[199,286,287,290],{},[184,288,289],{},"Rate limits."," Each token and each organization has a request budget per minute, and every response says how much is left, so one runaway script cannot affect anyone else.",[199,292,293,296],{},[184,294,295],{},"Signed webhooks."," Every delivery is signed using the open Standard Webhooks scheme, so your receiver can prove it came from us and has not been replayed. Endpoints must use HTTPS, the signing secret is shown once and stored encrypted, and payloads contain only what the endpoint's owner is allowed to read.",[199,298,299,302],{},[184,300,301],{},"Everything is on the record."," Every change made through the API is written to the audit log, marked as made through the API and naming the token that made it.",[173,304,306],{"id":305},"getting-started","Getting started",[12,308,309,310,313],{},"An executive switches the API on under ",[184,311,312],{},"Settings → API",", where your organization also chooses who may create tokens and how long a token may last. From there you create a token — from a ready-made template such as Leave sync or Read-only directory, or with exactly the scopes you choose — and add webhook endpoints.",[12,315,316,317,324],{},"The full reference, with every endpoint, a downloadable OpenAPI description and a Postman collection, is in the app, and the guides are in our documentation: ",[318,319,323],"a",{"href":320,"rel":321},"https://docs.bookyourpto.com/api/overview",[322],"nofollow","API overview",".",{"title":16,"searchDepth":17,"depth":17,"links":326},[327,328,329,330,331],{"id":175,"depth":17,"text":176},{"id":190,"depth":17,"text":191},{"id":234,"depth":17,"text":235},{"id":248,"depth":17,"text":249},{"id":305,"depth":17,"text":306},"2026-10-13","Read and write people, leave, time and expense data from your own scripts and tools, and get a signed webhook the moment something changes. Every token acts as a real person in your organization and can never see more than they can.","https://images.unsplash.com/photo-1611926653458-09294b3142bf?w=1200&h=630&fit=crop",{},"6 min read",{"title":168,"description":333},"blog/public-api-and-webhooks",[340,341,342,343],"product","api","integrations","security","tOx9rc6BhnF3REmEypIRe2-1T2i95SQXh7Inv4XJuVo",[346,548,772],{"id":347,"title":348,"author":169,"body":349,"date":536,"description":537,"extension":19,"image":538,"meta":539,"navigation":7,"path":540,"readTime":541,"seo":542,"stem":543,"tags":544,"__hash__":547},"blog/blog/home-page-what-needs-you.md","A Home Page That Opens on What Needs You",{"type":9,"value":350,"toc":526},[351,355,358,365,369,381,384,391,395,431,435,449,453,456,484,488,494,497,501,508,514,516],[173,352,354],{"id":353},"where-a-working-day-should-start","Where a working day should start",[12,356,357],{},"For a long time, signing in to BookYourPTO dropped you on the Dashboard: a calendar grid built to answer \"who is off, and when\". It answers that question well. It answers almost nothing else. A document waiting on your signature, an assessment somebody is waiting for, a leave request routed to you for a decision — each lived behind a sidebar entry you had to think to visit.",[12,359,360,361,364],{},"Signing in now lands on ",[184,362,363],{},"Home",". It gathers what needs you, your own records, and — for people who manage or administer — their team and the organization. The Dashboard has not gone anywhere; it is still in the sidebar, unchanged.",[173,366,368],{"id":367},"what-needs-you-comes-first","What needs you comes first",[12,370,371,372,375,376,380],{},"The first card is ",[184,373,374],{},"Action Required",": documents waiting on your signature, assessments you owe somebody, onboarding tasks and training past their date, and certifications that have expired. Each row says what it is for and opens the page where you deal with it. An onboarding task assigned to you for a new starter opens ",[377,378,379],"em",{},"their"," onboarding, where the task lives, not your own.",[12,382,383],{},"This is the one card that cannot be switched off. When there is nothing outstanding it says so, rather than disappearing — \"you are clear\" is information too.",[12,385,386,387,390],{},"Beside it, ",[184,388,389],{},"Waiting on You"," appears for anyone requests are routed to, with leave, expense and time requests counted separately, each count matching the queue it opens.",[173,392,394],{"id":393},"your-own-record-at-a-glance","Your own record, at a glance",[196,396,397,403,409,419,425],{},[199,398,399,402],{},[184,400,401],{},"Time Off"," — your Annual and Sick balances, the same figures as the Leave Balance panel on your calendar, and your next booked leave.",[199,404,405,408],{},[184,406,407],{},"Today's Hours"," — hours logged today and whether you are clocked in, when your organization uses time tracking.",[199,410,411,414,415,418],{},[184,412,413],{},"My Expenses"," and ",[184,416,417],{},"My Documents"," — your claims and documents by where they have got to, naming the most recent ones so you know which report is awaiting approval, not only how many.",[199,420,421,424],{},[184,422,423],{},"Next 1:1"," — who you next speak to, and when.",[199,426,427,430],{},[184,428,429],{},"My Stuff"," — a line each for goals, training, certifications, benefits and equipment.",[173,432,434],{"id":433},"what-is-happening-around-you","What is happening around you",[12,436,437,440,441,444,445,448],{},[184,438,439],{},"Who's Out"," shows who is away today and, over the next fortnight, who is away on which day — with their photo and the type of leave. ",[184,442,443],{},"Celebrations"," lists birthdays and work anniversaries over the next two weeks. Anyone with people reporting to them gets ",[184,446,447],{},"My Team",": who is away and when they next speak to each. Department heads also see the onboarding still running in their own department, and administrators and executives see onboarding across the organization along with headcount, review cycles and what needs attention.",[173,450,452],{"id":451},"every-card-follows-the-rules-you-already-set","Every card follows the rules you already set",[12,454,455],{},"Home restates information that other parts of the product own, so it follows their rules rather than inventing its own:",[196,457,458,465,471,474,481],{},[199,459,460,461,464],{},"With ",[184,462,463],{},"other departments hidden",", Who's Out and Celebrations show only your own department, as the Dashboard does. Administrators and executives are exempt, as the setting says.",[199,466,467,470],{},[184,468,469],{},"Private leave types"," read as \"Private\" to anyone not entitled to the detail.",[199,472,473],{},"Who's Out sends a name, a date and a leave type — the reason somebody gave for being away stays on the server.",[199,475,476,477,480],{},"A ",[184,478,479],{},"work anniversary"," reveals tenure, so it is shown only to the person, their manager, their department head, and administrators and executives.",[199,482,483],{},"A module your organization has switched off — time tracking, say — does not appear on Home and cannot be added to it.",[173,485,487],{"id":486},"arrange-it-your-way","Arrange it your way",[12,489,490,493],{},[184,491,492],{},"Customise"," turns the board into an editor. Drag a card to move it, or use the arrow keys; remove the ones you do not need; and add optional cards from the tray — Company Holidays, Leave Balance, Deductible and Non-deductible Leave, Organization Time for anyone working away from head office's timezone, and, for administrators and executives, Workforce Mix, Length of Service and Profile Completeness. Nothing is saved until you select Save.",[12,495,496],{},"Your layout is stored on your account rather than in the browser, so it follows you to another device. Switching a card off changes only what you see: it grants no access, and every card's data is still permission-checked on the server.",[173,498,500],{"id":499},"an-org-chart-you-can-trust-and-take-with-you","An org chart you can trust — and take with you",[12,502,503,504,507],{},"Home's My Team card links to the org chart, which is now built from the ",[184,505,506],{},"Reports To"," field and nothing else. It used to infer reporting lines from roles; now every line on it is one somebody recorded. A person whose manager has left, who is recorded as their own manager, or who is caught in a reporting loop surfaces at the top of the chart, so the record that needs fixing is visible.",[12,509,510,513],{},[184,511,512],{},"Export"," offers a PNG of the chart as drawn, the same image as a PDF, and a .csv shaped for Visio, for Lucidchart, or for a spreadsheet. Who may download is a separate setting from who may browse, and every download, in every format, is recorded in the audit log — an export is a roster in a file, and it should be possible to say who took one.",[173,515,306],{"id":305},[12,517,518,519,521,522,525],{},"There is nothing to switch on. Sign in and you are on Home; select ",[184,520,492],{}," to make it yours. Administrators can set who may download the org chart under ",[184,523,524],{},"Download Access"," in Company Directory settings.",{"title":16,"searchDepth":17,"depth":17,"links":527},[528,529,530,531,532,533,534,535],{"id":353,"depth":17,"text":354},{"id":367,"depth":17,"text":368},{"id":393,"depth":17,"text":394},{"id":433,"depth":17,"text":434},{"id":451,"depth":17,"text":452},{"id":486,"depth":17,"text":487},{"id":499,"depth":17,"text":500},{"id":305,"depth":17,"text":306},"2026-10-01","Signing in to BookYourPTO now lands on Home: a board of cards built for your role that starts with what is waiting on you, can be rearranged to suit you, and respects every privacy setting your organization already has.","https://assets.bookyourpto.com/blog/home-page-cover.webp",{},"/blog/home-page-what-needs-you","5 min read",{"title":348,"description":537},"blog/home-page-what-needs-you",[340,545,546],"home","org chart","wg8-y8bp8k8Wv67jNqvo3aXf0XeIzf1zlvR3PWA2HNc",{"id":549,"title":550,"author":169,"body":551,"date":759,"description":760,"extension":19,"image":761,"meta":762,"navigation":7,"path":763,"readTime":336,"seo":764,"stem":765,"tags":766,"__hash__":771},"blog/blog/probation-period-reviews-checklist.md","Probation Period Reviews: A Practical Checklist for Managers",{"type":9,"value":552,"toc":748},[553,557,560,563,568,572,575,595,598,602,605,631,634,641,645,648,662,665,669,672,692,696,699,710,713,717,720,724,741,745],[173,554,556],{"id":555},"the-deadline-that-sneaks-up","The deadline that sneaks up",[12,558,559],{},"Most people decisions can wait a week. The end of a probation period usually cannot. It falls on a specific date, it often has contractual weight, and if it passes without a conversation, the decision tends to make itself — the person is simply confirmed, ready or not.",[12,561,562],{},"That is how probation reviews go wrong in small companies: not through bad judgment, but through a date nobody noticed until it had gone. This checklist covers the practical side — tracking the date, telling the right people, extending well, and keeping a clean record.",[12,564,565],{},[377,566,567],{},"A note before we start: probation rules differ by country, province and state, and by employment contract. Nothing here is legal advice. Check what your contracts and local employment law say about notice, extensions and what a probation period permits.",[173,569,571],{"id":570},"_1-record-the-period-not-just-the-start-date","1. Record the period, not just the start date",[12,573,574],{},"A probation review date is calculated, and calculations need inputs:",[196,576,577,583,589],{},[199,578,579,582],{},[184,580,581],{},"The start date"," — the employee's first day of employment.",[199,584,585,588],{},[184,586,587],{},"The length of the period"," — commonly expressed in months, and sometimes different by role or seniority.",[199,590,591,594],{},[184,592,593],{},"Any extension"," — a later date that replaces the original if the period is extended.",[12,596,597],{},"Store all three on the employee's own record. A review date written only in a calendar invite, or in a manager's notes, is lost the moment that manager changes jobs.",[173,599,601],{"id":600},"_2-decide-who-should-know-it-is-coming","2. Decide who should know it is coming",[12,603,604],{},"A probation review is personal. It should be visible to the people who have a reason to act on it, and to nobody else:",[196,606,607,613,619,625],{},[199,608,609,612],{},[184,610,611],{},"The employee themselves."," Nobody should discover their own review date from someone else.",[199,614,615,618],{},[184,616,617],{},"Their manager."," They hold the conversation.",[199,620,621,624],{},[184,622,623],{},"Their department head."," They are accountable for the team.",[199,626,627,630],{},[184,628,629],{},"Administrators and executives."," They maintain people records and may need to act on the outcome.",[12,632,633],{},"Colleagues do not need to see it. A team calendar that shows everyone's upcoming probation reviews tells a team who is still \"on trial\", which helps nobody. If your system shows probation milestones on a shared calendar or a home page, check that they are limited to this list.",[12,635,636,637,640],{},"One edge case to watch: a rule like \"department heads see probation for their department\" should never match a department head who has ",[184,638,639],{},"no"," department assigned against employees who also have none. Two empty values are not the same department.",[173,642,644],{"id":643},"_3-give-the-manager-enough-lead-time","3. Give the manager enough lead time",[12,646,647],{},"The review itself is a short conversation; the preparation is not. A useful rhythm:",[196,649,650,656],{},[199,651,652,655],{},[184,653,654],{},"About two weeks before"," — a reminder to look back over the period: goals, feedback from colleagues, any one-to-one notes.",[199,657,658,661],{},[184,659,660],{},"A few days before"," — a reminder to book the conversation if it is not already in the calendar.",[12,663,664],{},"The reminder should go to the manager directly. An HR inbox that has to forward it adds a step that eventually gets missed.",[173,666,668],{"id":667},"_4-extend-deliberately-not-by-default","4. Extend deliberately, not by default",[12,670,671],{},"Sometimes the right answer is \"not yet\" — the role changed, the manager changed, or there has not been enough time to judge fairly. An extension can be the fairest outcome, provided it is a decision rather than a drift:",[196,673,674,680,686],{},[199,675,676,679],{},[184,677,678],{},"Agree the new date"," and record it as an extension, so the original date is not quietly forgotten.",[199,681,682,685],{},[184,683,684],{},"Say what needs to be different"," by the new date, specifically enough that both sides can tell whether it happened.",[199,687,688,691],{},[184,689,690],{},"Check what your contracts allow."," Some limit how long a probation period can be extended, or require notice.",[173,693,695],{"id":694},"_5-hold-the-conversation-then-write-it-down","5. Hold the conversation, then write it down",[12,697,698],{},"Keep the review itself simple:",[196,700,701,704,707],{},[199,702,703],{},"What has gone well, with examples.",[199,705,706],{},"What needs to improve, with examples.",[199,708,709],{},"The outcome: confirmed, extended (with the new date), or ended.",[12,711,712],{},"Then record it on the employee's file the same day — a short note, or a signed review form if your process uses one. A decision that only exists in two people's memories is not a record.",[173,714,716],{"id":715},"_6-make-probation-part-of-onboarding-not-separate-from-it","6. Make probation part of onboarding, not separate from it",[12,718,719],{},"The best probation reviews confirm what everyone already knows. That happens when the period itself has structure: an onboarding checklist in the first weeks, regular one-to-ones, and clear goals. By the time the review arrives, the evidence is already written down.",[173,721,723],{"id":722},"the-checklist","The checklist",[196,725,726,729,732,735,738],{},[199,727,728],{},"Store the start date, period length and any extension on the employee's record.",[199,730,731],{},"Show the review date only to the employee, their manager, their department head, and administrators and executives.",[199,733,734],{},"Remind the manager about two weeks ahead, and again a few days ahead.",[199,736,737],{},"Extend deliberately: new date, specific expectations, and a check against your contracts.",[199,739,740],{},"Record the outcome on the employee's file the same day.",[173,742,744],{"id":743},"how-bookyourpto-handles-it","How BookYourPTO handles it",[12,746,747],{},"In BookYourPTO, each employee's probation review lives on their profile with its own period, extension date and reminders. Upcoming probation reviews appear on the Dashboard and in the Probation Reviews card on Home for the next two weeks, visible only to the employee, their manager, their department head, and administrators and executives — and a department head with no department assigned does not see the probation data of other unassigned employees. For teams that want a recurring check-in on top, a review cycle can be set to fall a set number of months after each employee's hire date.",{"title":16,"searchDepth":17,"depth":17,"links":749},[750,751,752,753,754,755,756,757,758],{"id":555,"depth":17,"text":556},{"id":570,"depth":17,"text":571},{"id":600,"depth":17,"text":601},{"id":643,"depth":17,"text":644},{"id":667,"depth":17,"text":668},{"id":694,"depth":17,"text":695},{"id":715,"depth":17,"text":716},{"id":722,"depth":17,"text":723},{"id":743,"depth":17,"text":744},"2026-09-24","The end of a probation period is one of the few people decisions with a fixed deadline. How to track it, who should know it is coming, when to extend, and how to keep the record straight — without turning it into paperwork.","https://images.unsplash.com/photo-1521791136064-7986c2920216?w=1200&h=630&fit=crop",{},"/blog/probation-period-reviews-checklist",{"title":550,"description":760},"blog/probation-period-reviews-checklist",[767,768,769,770],"probation","onboarding","performance","guides","zHdOIQ-fe8LGMvo45252-LxzJs8FYjKOCYWuMNEmpHs",{"id":773,"title":774,"author":169,"body":775,"date":958,"description":959,"extension":19,"image":960,"meta":961,"navigation":7,"path":962,"readTime":963,"seo":964,"stem":965,"tags":966,"__hash__":969},"blog/blog/org-chart-from-reports-to.md","An Org Chart That Matches Reality: Build It From Reporting Lines, Not Job Titles",{"type":9,"value":776,"toc":948},[777,781,784,791,795,801,807,811,814,834,837,841,844,864,868,871,874,889,893,896,899,913,917,934,936],[173,778,780],{"id":779},"the-chart-everyone-screenshots-and-nobody-trusts","The chart everyone screenshots and nobody trusts",[12,782,783],{},"Ask a growing company for its org chart and you will usually get one of two things: a slide that was accurate the week it was made, or a diagram generated by an HR tool that looks authoritative but quietly guesses. Both get screenshotted into onboarding decks and board packs. Neither can be relied on.",[12,785,786,787,790],{},"The fix is not a better drawing tool. It is deciding what the chart is drawn ",[184,788,789],{},"from"," — and making that one field the only source.",[173,792,794],{"id":793},"two-ways-a-chart-goes-wrong","Two ways a chart goes wrong",[12,796,797,800],{},[184,798,799],{},"Drawn by hand."," A diagram in a slide deck or a whiteboard tool is disconnected from the people records. It is right on the day it is made and starts drifting the next morning: someone changes manager, someone leaves, a team is split. Nobody updates the slide, because nobody owns it.",[12,802,803,806],{},[184,804,805],{},"Inferred from roles."," Some systems draw the chart from job titles or permission roles: department heads report to an administrator, administrators report to an executive. It looks tidy, but the lines are invented. If a system hands department heads to administrators \"in turn\", the third person in a list reports to the first administrator purely because of their position in the list. Anyone reading that chart as a reporting structure is being misled — and the \"Reports To\" field people carefully filled in is ignored.",[173,808,810],{"id":809},"one-source-the-reporting-line","One source: the reporting line",[12,812,813],{},"Every person record has, or should have, one field that says who they report to. Draw the chart from that field and nothing else:",[196,815,816,822,828],{},[199,817,818,821],{},[184,819,820],{},"Role affects order, not structure."," An executive is not automatically at the top. If the CEO reports to a founder or a board, they appear beneath them.",[199,823,824,827],{},[184,825,826],{},"Anyone who reports to nobody is a top-level person."," A chart can legitimately have more than one root — a founder and an independent board member, for example.",[199,829,830,833],{},[184,831,832],{},"Problems surface instead of vanishing."," Three situations break a naive chart: a person whose manager has been deactivated, a person recorded as their own manager, and a reporting loop (A reports to B, B reports to A). A good chart shows each of these at the top level so the record that needs fixing is visible, rather than silently dropping the person.",[12,835,836],{},"That last point matters more than it sounds. An org chart that hides broken records looks clean and is wrong. One that shows them is a to-do list for whoever maintains people data.",[173,838,840],{"id":839},"keep-the-chart-and-the-records-in-agreement","Keep the chart and the records in agreement",[12,842,843],{},"If the chart is drawn from the reporting line, keeping it accurate becomes a data-entry habit rather than a design task:",[196,845,846,852,858],{},[199,847,848,851],{},[184,849,850],{},"Change the manager on the record, not on the chart."," The chart should have no data of its own.",[199,853,854,857],{},[184,855,856],{},"Handle leavers on the same day."," When someone leaves, their direct reports need a new manager; otherwise they will float to the top of the chart, which is exactly the signal you want.",[199,859,860,863],{},[184,861,862],{},"Review the top level occasionally."," Anyone at the top who should not be is almost always a missing or broken reporting line.",[173,865,867],{"id":866},"exporting-without-forking","Exporting without forking",[12,869,870],{},"People will always need the chart outside the system: a slide for an all-hands, a page in a handbook, or a redrawn version in Visio or Lucidchart for a reorganization plan. The trap is that every export becomes a new, unmaintained copy.",[12,872,873],{},"Two rules keep exports honest:",[875,876,877,883],"ol",{},[199,878,879,882],{},[184,880,881],{},"Export from the same field the chart uses."," A picture of the chart as drawn, a PDF of the same image, and a spreadsheet of people and their managers should all come from the reporting line, so a download can never disagree with the chart it came from.",[199,884,885,888],{},[184,886,887],{},"Export only what the chart shows."," A chart shows names, titles, departments and reporting lines. It should not quietly include employee numbers, salaries, or any other HR field just because they happen to be in the database.",[173,890,892],{"id":891},"who-should-be-able-to-download-it","Who should be able to download it?",[12,894,895],{},"Browsing the chart and downloading it are different things. An export is a roster in a file: it leaves the system, outlives the session, and forwards like any other attachment. Many organizations are happy for everyone to look at the chart, but prefer that only certain people can take a copy away.",[12,897,898],{},"That suggests two practices:",[196,900,901,907],{},[199,902,903,906],{},[184,904,905],{},"Make download access its own setting",", separate from who can view the chart — and make sure somebody who cannot view the chart can never download it.",[199,908,909,912],{},[184,910,911],{},"Record every download."," Who exported the chart, when, and in what format should be answerable from an audit log, so an organization can see where its roster has gone.",[173,914,916],{"id":915},"a-short-checklist","A short checklist",[196,918,919,922,925,928,931],{},[199,920,921],{},"Draw the chart from each person's reporting line and from nothing else.",[199,923,924],{},"Let role decide order at the top, never structure.",[199,926,927],{},"Show orphaned, self-managed and looping records at the top so they get fixed.",[199,929,930],{},"Export from the same source, and export only what the chart shows.",[199,932,933],{},"Set download access separately from viewing, and log every download.",[173,935,744],{"id":743},[12,937,938,939,941,942,944,945,947],{},"The BookYourPTO org chart is built from the ",[184,940,506],{}," field and nothing else. People who report to nobody, people whose manager is deactivated, people recorded as their own manager, and people caught in a reporting loop all surface at the top rather than disappearing. ",[184,943,512],{}," offers a PNG of the chart as drawn, the same image as a PDF, and a .csv shaped for Visio, for Lucidchart, or unformatted for a spreadsheet — all built from the same field, and carrying only what the chart shows. Who can download is set under ",[184,946,524],{}," in Company Directory settings, separately from who can browse, and every download in every format is recorded in the audit log.",{"title":16,"searchDepth":17,"depth":17,"links":949},[950,951,952,953,954,955,956,957],{"id":779,"depth":17,"text":780},{"id":793,"depth":17,"text":794},{"id":809,"depth":17,"text":810},{"id":839,"depth":17,"text":840},{"id":866,"depth":17,"text":867},{"id":891,"depth":17,"text":892},{"id":915,"depth":17,"text":916},{"id":743,"depth":17,"text":744},"2026-09-17","Most org charts drift because they are drawn by hand or inferred from job titles. Why the reporting line should be the only source, what goes wrong when it is not, and how to keep the chart and the people records in agreement.","https://assets.bookyourpto.com/blog/org-chart-cover.webp",{},"/blog/org-chart-from-reports-to","7 min read",{"title":774,"description":959},"blog/org-chart-from-reports-to",[546,967,968,770],"employee directory","people data","jugtjXP7fSm4t8h4MU3LePYzvJaqlPJYaGhPffke_yY",1791927948491]