[{"data":1,"prerenderedAt":992},["ShallowReactive",2],{"announcements":3,"blog-/blog/work-anniversaries-employee-privacy":184,"blog-related-/blog/work-anniversaries-employee-privacy":398},[4,28,46,64,80,96,112,130,148,166],{"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/data-import.md","Move your team over from 48 HR and payroll platforms — employees, leave history and departments",true,{"type":9,"value":10,"toc":15},"minimark",[11],[12,13,14],"p",{},"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":18},"",2,[],"md","/switch-from","See the platforms",{},14,"/announcements/data-import",{"title":6,"description":14},"announcements/data-import","MvYRLBetKwuvH2CJd2LvSm2chpmyLpInw_paM6_39lY",{"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/review-cycles.md","Review cycles that run themselves — anniversary or fixed dates, reminders, notes and the signed form in one place",{"type":9,"value":32,"toc":36},[33],[12,34,35],{},"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":37},[],"/features#performance","See performance",{},15,"/announcements/review-cycles",{"title":30,"description":35},"announcements/review-cycles","UI4uhTFm26-dfu_MknZSaKWT4ps3qQqSub0hB5MLNdU",{"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/home-page.md","A home page that opens on what needs you — role-aware cards you can add, remove and rearrange",{"type":9,"value":50,"toc":54},[51],[12,52,53],{},"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":55},[],"/features","See features",{},16,"/announcements/home-page",{"title":48,"description":53},"announcements/home-page","WV7nAzSgeff8xq63MYSyyNUWfHyC4WegQVzJPo6pjwA",{"id":65,"title":66,"active":7,"body":67,"description":71,"extension":19,"link":56,"linkText":57,"meta":74,"navigation":7,"order":75,"path":76,"seo":77,"stem":78,"__hash__":79},"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":68,"toc":72},[69],[12,70,71],{},"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":73},[],{},17,"/announcements/org-chart-reports-to",{"title":66,"description":71},"announcements/org-chart-reports-to","lDhWlPTbw2R3tIDNwVFrARNTWd0q0yBcbAoG_1fozUo",{"id":81,"title":82,"active":7,"body":83,"description":87,"extension":19,"link":56,"linkText":57,"meta":90,"navigation":7,"order":91,"path":92,"seo":93,"stem":94,"__hash__":95},"announcements/announcements/document-owner.md","Choose whose document it is when you send one for signature",{"type":9,"value":84,"toc":88},[85],[12,86,87],{},"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":89},[],{},18,"/announcements/document-owner",{"title":82,"description":87},"announcements/document-owner","_Cq3hJJ4LHxH5DoZUR7vrgXKJQG08fdG3FHSRpPlwP0",{"id":97,"title":98,"active":7,"body":99,"description":103,"extension":19,"link":56,"linkText":57,"meta":106,"navigation":7,"order":107,"path":108,"seo":109,"stem":110,"__hash__":111},"announcements/announcements/reports-details-and-smoother-pages.md","Reports open the detail you clicked, and pages stay still",{"type":9,"value":100,"toc":104},[101],[12,102,103],{},"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":105},[],{},19,"/announcements/reports-details-and-smoother-pages",{"title":98,"description":103},"announcements/reports-details-and-smoother-pages","CaYjA92fiC1V9prglnznYDQKVtdYJSWl2Kp1kYDckC8",{"id":113,"title":114,"active":7,"body":115,"description":119,"extension":19,"link":122,"linkText":123,"meta":124,"navigation":7,"order":125,"path":126,"seo":127,"stem":128,"__hash__":129},"announcements/announcements/expense-claim-redesign.md","Expense claims, redesigned",{"type":9,"value":116,"toc":120},[117],[12,118,119],{},"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":121},[],"/expenses","See expenses",{},20,"/announcements/expense-claim-redesign",{"title":114,"description":119},"announcements/expense-claim-redesign","n91G7jkYNzcDLQaXH-QelEauU-0tqsZ05IaOT0-u1-k",{"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/public-api-and-webhooks.md","A public REST API and signed webhooks, on every paid plan",{"type":9,"value":134,"toc":138},[135],[12,136,137],{},"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":139},[],"/blog/public-api-and-webhooks","Read the announcement",{},21,"/announcements/public-api-and-webhooks",{"title":132,"description":137},"announcements/public-api-and-webhooks","G6PRPGX0EzKXD6F2BASJVCTUpv8I7mOvMdLbdZ3CDc4",{"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/mobile-app-launch.md","The BookYourPTO app is on iPhone and Android — leave, approvals & expenses on the go",{"type":9,"value":152,"toc":156},[153],[12,154,155],{},"The BookYourPTO mobile app is now on Google Play as well as the App Store. Book leave, approve requests, clock in and out and claim expenses from your phone, signed in with the same account you use on the web.",{"title":16,"searchDepth":17,"depth":17,"links":157},[],"/mobile-app","Get the app",{},22,"/announcements/mobile-app-launch",{"title":150,"description":155},"announcements/mobile-app-launch","6GA1Z2mFIMhC5E9Gq46fEpP7ZOWZjj921KQY0rrOR0g",{"id":167,"title":168,"active":7,"body":169,"description":173,"extension":19,"link":176,"linkText":177,"meta":178,"navigation":7,"order":179,"path":180,"seo":181,"stem":182,"__hash__":183},"announcements/announcements/template-versions.md","Update a signed policy without starting over — template versions",{"type":9,"value":170,"toc":174},[171],[12,172,173],{},"When a document needs a change after people have signed it, upload the amended file as a new version of the same template. It keeps its name, signers and signing fields, documents already sent keep the version they were signed on, and Bulk Send only ever offers the current one. Templates are now listed in one searchable table with each template's version and upload date.",{"title":16,"searchDepth":17,"depth":17,"links":175},[],"https://docs.bookyourpto.com/documents/templates-and-bulk-send#updating-a-template-after-it-has-been-sent","How versions work",{},23,"/announcements/template-versions",{"title":168,"description":173},"announcements/template-versions","JYwWPTxknDHoragGL9x-O9fIqwQP2Zr9V9zdUm9a4TU",{"id":185,"title":186,"author":187,"body":188,"date":384,"description":385,"extension":19,"image":386,"meta":387,"navigation":7,"path":388,"readTime":389,"seo":390,"stem":391,"tags":392,"__hash__":397},"blog/blog/work-anniversaries-employee-privacy.md","Who Should See an Employee's Work Anniversary? Celebrations, Hire Dates, and Privacy","AnHourTec Team",{"type":9,"value":189,"toc":375},[190,195,198,206,228,231,235,238,252,255,259,262,288,291,295,298,319,322,329,333,340,347,351,368,372],[191,192,194],"h2",{"id":193},"a-small-gesture-with-a-data-question-underneath","A small gesture with a data question underneath",[12,196,197],{},"\"Happy five years, Sam!\" in the team channel is one of the cheapest, warmest things a company can do. Most HR systems make it automatic: a celebrations widget, a line in the weekly digest, a reminder to managers. Nobody thinks of it as a privacy decision.",[12,199,200,201,205],{},"But a work anniversary is not just a nice date. It is calculated from somebody's ",[202,203,204],"strong",{},"hire date",", and a hire date is employment information. Put a list of anniversaries in front of the whole company and you have also published:",[207,208,209,216,222],"ul",{},[210,211,212,215],"li",{},[202,213,214],{},"Tenure"," — exactly how long each person has been here.",[210,217,218,221],{},[202,219,220],{},"Relative seniority"," — who joined before whom, which people often read as pay or standing.",[210,223,224,227],{},[202,225,226],{},"Who is new"," — including in teams where a new hire may be a sensitive replacement.",[12,229,230],{},"None of that is secret in a five-person startup. In a fifty-person company with several departments, it is information many people would not expect to be broadcast — and most organizations never decided to broadcast it. The widget simply did.",[191,232,234],{"id":233},"birthdays-and-anniversaries-are-not-the-same-kind-of-data","Birthdays and anniversaries are not the same kind of data",[12,236,237],{},"It helps to separate the two:",[207,239,240,246],{},[210,241,242,245],{},[202,243,244],{},"A birthday",", shown as a day and month with no year, tells colleagues nothing about someone's employment. Most people are comfortable with it being shared, and it is easy to let people opt out.",[210,247,248,251],{},[202,249,250],{},"A work anniversary"," is employment data wearing a party hat. It belongs with the rest of a person's employment record, and the question of who sees it should have the same answer as \"who sees their start date\".",[12,253,254],{},"A reasonable default follows from that: share birthdays widely (without the year), and show work anniversaries to the people who already have a reason to know someone's start date.",[191,256,258],{"id":257},"who-has-a-reason-to-know","Who has a reason to know?",[12,260,261],{},"For most organizations, that is a short list:",[207,263,264,270,276,282],{},[210,265,266,269],{},[202,267,268],{},"The employee themselves."," It is their milestone.",[210,271,272,275],{},[202,273,274],{},"Their manager."," They are the person most likely to mark it, and they already know the start date.",[210,277,278,281],{},[202,279,280],{},"Their department head."," They are responsible for the team the person sits in.",[210,283,284,287],{},[202,285,286],{},"Administrators and executives."," They run the organization's people records.",[12,289,290],{},"Everyone else can still celebrate — the manager can post the message, and the team can join in. What changes is that the system is not quietly handing every colleague a tenure table.",[191,292,294],{"id":293},"the-three-places-anniversaries-leak","The three places anniversaries leak",[12,296,297],{},"When you tighten the rule, apply it everywhere the date appears. In practice, there are usually three surfaces, and they are often built separately:",[299,300,301,307,313],"ol",{},[210,302,303,306],{},[202,304,305],{},"The dashboard or home page"," — a celebrations card listing the next fortnight's milestones.",[210,308,309,312],{},[202,310,311],{},"Digest emails"," — the daily or weekly summary, which can travel further than any screen because emails are forwarded and archived.",[210,314,315,318],{},[202,316,317],{},"Monthly or scheduled reminders"," — \"anniversaries this month\", often sent to department heads.",[12,320,321],{},"The classic failure is fixing the first and forgetting the other two, so the card respects the rule while the Monday email still goes to everyone. If your system lets you, check that all three read the same rule rather than each having its own.",[12,323,324,325,328],{},"Watch for one more edge case: ",[202,326,327],{},"a department head who has not been assigned a department yet",". A rule written as \"department heads see their department\" can fail open for that person and show them every anniversary in the company. The safe behaviour is the opposite — no department, no department-wide view.",[191,330,332],{"id":331},"respect-the-settings-you-already-have","Respect the settings you already have",[12,334,335,336,339],{},"Many organizations have already made a related decision without connecting it to celebrations. If your directory is set so that ",[202,337,338],{},"other departments are hidden"," from regular employees, your celebrations should follow the same boundary. A birthday list that crosses departments when the directory does not is the kind of inconsistency people notice.",[12,341,342,343,346],{},"The same goes for ",[202,344,345],{},"private leave types",": if somebody's absence is recorded as private, a \"who's out\" list should say \"Private\" to anyone not entitled to the detail — and should never include the reason they gave for being away.",[191,348,350],{"id":349},"a-short-policy-you-can-adopt","A short policy you can adopt",[207,352,353,356,359,362,365],{},[210,354,355],{},"Birthdays: shown to colleagues as day and month only, never the year.",[210,357,358],{},"Work anniversaries: shown to the employee, their manager, their department head, and administrators and executives.",[210,360,361],{},"Every surface — dashboard, home page, digest emails and scheduled reminders — follows the same rule.",[210,363,364],{},"Department-level visibility settings apply to celebrations too.",[210,366,367],{},"Managers are encouraged to mark milestones publicly themselves, where the person is comfortable with it.",[191,369,371],{"id":370},"how-bookyourpto-handles-it","How BookYourPTO handles it",[12,373,374],{},"In BookYourPTO, a work anniversary is shown to the employee, their manager, their department head, and administrators and executives — on the dashboard, on the Celebrations card on Home, and in both the daily and weekly digest emails, which all read the same rule. Birthdays are shared more widely and the year is never sent. When an organization hides other departments, Celebrations and Who's Out are limited to a non-administrator's own department, and private leave types read as \"Private\" to anyone not entitled to the detail.",{"title":16,"searchDepth":17,"depth":17,"links":376},[377,378,379,380,381,382,383],{"id":193,"depth":17,"text":194},{"id":233,"depth":17,"text":234},{"id":257,"depth":17,"text":258},{"id":293,"depth":17,"text":294},{"id":331,"depth":17,"text":332},{"id":349,"depth":17,"text":350},{"id":370,"depth":17,"text":371},"2026-09-10","Celebrating anniversaries and birthdays builds culture, but a work anniversary is derived from a hire date — employment information. A practical guide to deciding who sees what in your directory, your dashboards and your digest emails.","https://images.unsplash.com/photo-1542744173-8e7e53415bb0?w=1200&h=630&fit=crop",{},"/blog/work-anniversaries-employee-privacy","6 min read",{"title":186,"description":385},"blog/work-anniversaries-employee-privacy",[393,394,395,396],"privacy","employee directory","culture","hr","XWj2Ku8xanO7N5JjvSRqqwk6xtHg_qyAEqsdkqMOgjU",[399,572,774],{"id":400,"title":401,"author":187,"body":402,"date":560,"description":561,"extension":19,"image":562,"meta":563,"navigation":7,"path":140,"readTime":389,"seo":564,"stem":565,"tags":566,"__hash__":571},"blog/blog/public-api-and-webhooks.md","Connect BookYourPTO to Your Own Systems: A Public REST API and Signed Webhooks",{"type":9,"value":403,"toc":553},[404,408,411,418,422,425,457,460,464,467,474,478,481,531,535,542],[191,405,407],{"id":406},"why-an-api-and-why-now","Why an API, and why now",[12,409,410],{},"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,412,413,414,417],{},"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 ",[202,415,416],{},"Pro, Business and Enterprise"," plans. They are off until an executive in your organization switches them on.",[191,419,421],{"id":420},"what-you-can-build-with-it","What you can build with it",[12,423,424],{},"A few of the jobs the API is shaped for:",[207,426,427,433,439,445,451],{},[210,428,429,432],{},[202,430,431],{},"HRIS and directory sync."," Read people, departments and teams, and create or update people from the system that owns your employee records.",[210,434,435,438],{},[202,436,437],{},"Payroll export."," Pull approved time entries, finalized timesheets, leave and leave balances for a pay period, in plain JSON, instead of assembling a spreadsheet.",[210,440,441,444],{},[202,442,443],{},"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.",[210,446,447,450],{},[202,448,449],{},"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.",[210,452,453,456],{},[202,454,455],{},"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,458,459],{},"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.",[191,461,463],{"id":462},"webhooks-be-told-rather-than-ask","Webhooks: be told, rather than ask",[12,465,466],{},"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,468,469,470,473],{},"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 ",[202,471,472],{},"Send test event"," button lets you check a new endpoint before relying on it.",[191,475,477],{"id":476},"the-security-model-in-plain-words","The security model, in plain words",[12,479,480],{},"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:",[207,482,483,489,495,501,507,513,519,525],{},[210,484,485,488],{},[202,486,487],{},"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.",[210,490,491,494],{},[202,492,493],{},"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.",[210,496,497,500],{},[202,498,499],{},"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.",[210,502,503,506],{},[202,504,505],{},"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.",[210,508,509,512],{},[202,510,511],{},"IP allowlists."," A token can be restricted to the addresses or ranges your servers actually call from.",[210,514,515,518],{},[202,516,517],{},"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.",[210,520,521,524],{},[202,522,523],{},"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.",[210,526,527,530],{},[202,528,529],{},"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.",[191,532,534],{"id":533},"getting-started","Getting started",[12,536,537,538,541],{},"An executive switches the API on under ",[202,539,540],{},"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,543,544,545,552],{},"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: ",[546,547,551],"a",{"href":548,"rel":549},"https://docs.bookyourpto.com/api/overview",[550],"nofollow","API overview",".",{"title":16,"searchDepth":17,"depth":17,"links":554},[555,556,557,558,559],{"id":406,"depth":17,"text":407},{"id":420,"depth":17,"text":421},{"id":462,"depth":17,"text":463},{"id":476,"depth":17,"text":477},{"id":533,"depth":17,"text":534},"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",{},{"title":401,"description":561},"blog/public-api-and-webhooks",[567,568,569,570],"product","api","integrations","security","tOx9rc6BhnF3REmEypIRe2-1T2i95SQXh7Inv4XJuVo",{"id":573,"title":574,"author":187,"body":575,"date":762,"description":763,"extension":19,"image":764,"meta":765,"navigation":7,"path":766,"readTime":767,"seo":768,"stem":769,"tags":770,"__hash__":773},"blog/blog/home-page-what-needs-you.md","A Home Page That Opens on What Needs You",{"type":9,"value":576,"toc":752},[577,581,584,591,595,607,610,617,621,657,661,675,679,682,710,714,720,723,727,734,740,742],[191,578,580],{"id":579},"where-a-working-day-should-start","Where a working day should start",[12,582,583],{},"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,585,586,587,590],{},"Signing in now lands on ",[202,588,589],{},"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.",[191,592,594],{"id":593},"what-needs-you-comes-first","What needs you comes first",[12,596,597,598,601,602,606],{},"The first card is ",[202,599,600],{},"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 ",[603,604,605],"em",{},"their"," onboarding, where the task lives, not your own.",[12,608,609],{},"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,611,612,613,616],{},"Beside it, ",[202,614,615],{},"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.",[191,618,620],{"id":619},"your-own-record-at-a-glance","Your own record, at a glance",[207,622,623,629,635,645,651],{},[210,624,625,628],{},[202,626,627],{},"Time Off"," — your Annual and Sick balances, the same figures as the Leave Balance panel on your calendar, and your next booked leave.",[210,630,631,634],{},[202,632,633],{},"Today's Hours"," — hours logged today and whether you are clocked in, when your organization uses time tracking.",[210,636,637,640,641,644],{},[202,638,639],{},"My Expenses"," and ",[202,642,643],{},"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.",[210,646,647,650],{},[202,648,649],{},"Next 1:1"," — who you next speak to, and when.",[210,652,653,656],{},[202,654,655],{},"My Stuff"," — a line each for goals, training, certifications, benefits and equipment.",[191,658,660],{"id":659},"what-is-happening-around-you","What is happening around you",[12,662,663,666,667,670,671,674],{},[202,664,665],{},"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. ",[202,668,669],{},"Celebrations"," lists birthdays and work anniversaries over the next two weeks. Anyone with people reporting to them gets ",[202,672,673],{},"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.",[191,676,678],{"id":677},"every-card-follows-the-rules-you-already-set","Every card follows the rules you already set",[12,680,681],{},"Home restates information that other parts of the product own, so it follows their rules rather than inventing its own:",[207,683,684,691,697,700,707],{},[210,685,686,687,690],{},"With ",[202,688,689],{},"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.",[210,692,693,696],{},[202,694,695],{},"Private leave types"," read as \"Private\" to anyone not entitled to the detail.",[210,698,699],{},"Who's Out sends a name, a date and a leave type — the reason somebody gave for being away stays on the server.",[210,701,702,703,706],{},"A ",[202,704,705],{},"work anniversary"," reveals tenure, so it is shown only to the person, their manager, their department head, and administrators and executives.",[210,708,709],{},"A module your organization has switched off — time tracking, say — does not appear on Home and cannot be added to it.",[191,711,713],{"id":712},"arrange-it-your-way","Arrange it your way",[12,715,716,719],{},[202,717,718],{},"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,721,722],{},"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.",[191,724,726],{"id":725},"an-org-chart-you-can-trust-and-take-with-you","An org chart you can trust — and take with you",[12,728,729,730,733],{},"Home's My Team card links to the org chart, which is now built from the ",[202,731,732],{},"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,735,736,739],{},[202,737,738],{},"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.",[191,741,534],{"id":533},[12,743,744,745,747,748,751],{},"There is nothing to switch on. Sign in and you are on Home; select ",[202,746,718],{}," to make it yours. Administrators can set who may download the org chart under ",[202,749,750],{},"Download Access"," in Company Directory settings.",{"title":16,"searchDepth":17,"depth":17,"links":753},[754,755,756,757,758,759,760,761],{"id":579,"depth":17,"text":580},{"id":593,"depth":17,"text":594},{"id":619,"depth":17,"text":620},{"id":659,"depth":17,"text":660},{"id":677,"depth":17,"text":678},{"id":712,"depth":17,"text":713},{"id":725,"depth":17,"text":726},{"id":533,"depth":17,"text":534},"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":574,"description":763},"blog/home-page-what-needs-you",[567,771,772],"home","org chart","wg8-y8bp8k8Wv67jNqvo3aXf0XeIzf1zlvR3PWA2HNc",{"id":775,"title":776,"author":187,"body":777,"date":979,"description":980,"extension":19,"image":981,"meta":982,"navigation":7,"path":983,"readTime":389,"seo":984,"stem":985,"tags":986,"__hash__":991},"blog/blog/probation-period-reviews-checklist.md","Probation Period Reviews: A Practical Checklist for Managers",{"type":9,"value":778,"toc":968},[779,783,786,789,794,798,801,821,824,828,831,853,856,863,867,870,884,887,891,894,914,918,921,932,935,939,942,946,963,965],[191,780,782],{"id":781},"the-deadline-that-sneaks-up","The deadline that sneaks up",[12,784,785],{},"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,787,788],{},"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,790,791],{},[603,792,793],{},"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.",[191,795,797],{"id":796},"_1-record-the-period-not-just-the-start-date","1. Record the period, not just the start date",[12,799,800],{},"A probation review date is calculated, and calculations need inputs:",[207,802,803,809,815],{},[210,804,805,808],{},[202,806,807],{},"The start date"," — the employee's first day of employment.",[210,810,811,814],{},[202,812,813],{},"The length of the period"," — commonly expressed in months, and sometimes different by role or seniority.",[210,816,817,820],{},[202,818,819],{},"Any extension"," — a later date that replaces the original if the period is extended.",[12,822,823],{},"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.",[191,825,827],{"id":826},"_2-decide-who-should-know-it-is-coming","2. Decide who should know it is coming",[12,829,830],{},"A probation review is personal. It should be visible to the people who have a reason to act on it, and to nobody else:",[207,832,833,838,843,848],{},[210,834,835,837],{},[202,836,268],{}," Nobody should discover their own review date from someone else.",[210,839,840,842],{},[202,841,274],{}," They hold the conversation.",[210,844,845,847],{},[202,846,280],{}," They are accountable for the team.",[210,849,850,852],{},[202,851,286],{}," They maintain people records and may need to act on the outcome.",[12,854,855],{},"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,857,858,859,862],{},"One edge case to watch: a rule like \"department heads see probation for their department\" should never match a department head who has ",[202,860,861],{},"no"," department assigned against employees who also have none. Two empty values are not the same department.",[191,864,866],{"id":865},"_3-give-the-manager-enough-lead-time","3. Give the manager enough lead time",[12,868,869],{},"The review itself is a short conversation; the preparation is not. A useful rhythm:",[207,871,872,878],{},[210,873,874,877],{},[202,875,876],{},"About two weeks before"," — a reminder to look back over the period: goals, feedback from colleagues, any one-to-one notes.",[210,879,880,883],{},[202,881,882],{},"A few days before"," — a reminder to book the conversation if it is not already in the calendar.",[12,885,886],{},"The reminder should go to the manager directly. An HR inbox that has to forward it adds a step that eventually gets missed.",[191,888,890],{"id":889},"_4-extend-deliberately-not-by-default","4. Extend deliberately, not by default",[12,892,893],{},"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:",[207,895,896,902,908],{},[210,897,898,901],{},[202,899,900],{},"Agree the new date"," and record it as an extension, so the original date is not quietly forgotten.",[210,903,904,907],{},[202,905,906],{},"Say what needs to be different"," by the new date, specifically enough that both sides can tell whether it happened.",[210,909,910,913],{},[202,911,912],{},"Check what your contracts allow."," Some limit how long a probation period can be extended, or require notice.",[191,915,917],{"id":916},"_5-hold-the-conversation-then-write-it-down","5. Hold the conversation, then write it down",[12,919,920],{},"Keep the review itself simple:",[207,922,923,926,929],{},[210,924,925],{},"What has gone well, with examples.",[210,927,928],{},"What needs to improve, with examples.",[210,930,931],{},"The outcome: confirmed, extended (with the new date), or ended.",[12,933,934],{},"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.",[191,936,938],{"id":937},"_6-make-probation-part-of-onboarding-not-separate-from-it","6. Make probation part of onboarding, not separate from it",[12,940,941],{},"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.",[191,943,945],{"id":944},"the-checklist","The checklist",[207,947,948,951,954,957,960],{},[210,949,950],{},"Store the start date, period length and any extension on the employee's record.",[210,952,953],{},"Show the review date only to the employee, their manager, their department head, and administrators and executives.",[210,955,956],{},"Remind the manager about two weeks ahead, and again a few days ahead.",[210,958,959],{},"Extend deliberately: new date, specific expectations, and a check against your contracts.",[210,961,962],{},"Record the outcome on the employee's file the same day.",[191,964,371],{"id":370},[12,966,967],{},"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":969},[970,971,972,973,974,975,976,977,978],{"id":781,"depth":17,"text":782},{"id":796,"depth":17,"text":797},{"id":826,"depth":17,"text":827},{"id":865,"depth":17,"text":866},{"id":889,"depth":17,"text":890},{"id":916,"depth":17,"text":917},{"id":937,"depth":17,"text":938},{"id":944,"depth":17,"text":945},{"id":370,"depth":17,"text":371},"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":776,"description":980},"blog/probation-period-reviews-checklist",[987,988,989,990],"probation","onboarding","performance","guides","zHdOIQ-fe8LGMvo45252-LxzJs8FYjKOCYWuMNEmpHs",1792553414549]