canonical: https://jentic.com/apis/busyboard.app/busyboard # Busyboard App BusyBoard API The BusyBoard API exposes cross-person busy and free availability while keeping the underlying event details private. You read the people and groups you can see, pull busy blocks for a set of users over a date range, and get a rolled-up availability summary. A find-time operation returns mutual free windows for a group, and a booking-proposals operation proposes a meeting time against that availability. ## For AI agents Read cross-person busy and free availability, find mutual open windows, and propose a meeting time without exposing event details. Authenticates with a bearer API key. ## Scope Does not expose event titles, attendees, or private calendar contents, and does not send email or video invites. Use for reading cross-person availability and proposing meeting times only. ## Capabilities - Read the people and groups an account can access - Pull busy blocks for a set of users over a date range - Get a rolled-up availability summary for a date and range - Find mutual free windows across several people - Propose a meeting time against shared availability ## Use cases ### Agent Meeting Scheduling An AI agent connected through Jentic reads a group's availability, finds a mutual free window, and proposes a meeting time, so scheduling happens without exposing anyone's private event details. Because BusyBoard returns only busy and free blocks, the agent can plan a time while event contents stay private. Example prompt: Find a 30-minute window next week when all five people are free and propose that time ### Team Availability Overview An assistant pulls busy blocks for a set of users across a date range and renders a shared availability view, so a planner sees who is free when without opening each calendar. The summary operation condenses a day or range into a single readable picture. Example prompt: Get busy blocks for the project group from Monday to Friday and summarize each person's free hours ### Privacy-Preserving Free/Busy Lookup An integration reads free and busy data for external and internal participants without accessing event titles or attendees, so scheduling respects privacy boundaries. The people and groups operations scope which availability a caller is allowed to see. Example prompt: Read the availability summary for the two named people today and return only their free windows ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/me` | Get the current user profile | | GET | `/people` | List accessible people | | GET | `/availability` | Get busy blocks for users | | GET | `/availability/summary` | Get a rolled-up availability summary | | GET | `/find-time` | Find mutual free time for a group | | GET | `/calendars` | List connected calendar accounts | | POST | `/booking-proposals` | Propose a meeting time | ## Key resources - **People and groups** — List the people and groups whose availability an account can access - **Availability** — Read busy blocks and rolled-up summaries over a date range - **Find time** — Return mutual free windows across several people - **Booking proposals** — Propose a meeting time against shared availability ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 60 / 100 - **Maturity:** Foundational - **Dimensions:** - Foundational Compliance: 59 / 100 - Developer Experience & Jentic Compatibility: 57 / 100 - AI-Readiness & Agent Experience: 44 / 100 - Agent Usability: 94 / 100 - Security: 60 / 100 - AI Discoverability: 76 / 100 - **View full report:** https://jentic.com/apis/busyboard.app/busyboard/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring the BusyBoard API by hand means handling its bearer key auth, passing user id and date-range parameters correctly, and combining the availability and find-time operations. Through Jentic you install once, import BusyBoard from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** You choose which operations your agent may call, so you can allow the read-availability and find-time operations and leave the booking-proposal operation out. The user ids and dates travel as parameters, so rules bound which operations run rather than which people are queried. - **Credential handling:** Your BusyBoard key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'find mutual free time' or 'get a group's busy blocks', and Jentic returns the matching BusyBoard operation with its input schema so the agent calls the right endpoint without reading the reference docs. ## Related APIs - **Calendly API** — Scheduling platform with availability rules and booking links - **Cronofy API** — Calendar connectivity and scheduling across Google, Microsoft, and Apple calendars - **Nylas API** — Unified calendar, email, and contacts connectivity ## FAQ ### Is there a BusyBoard MCP server? You don't need an MCP server to give your agent the BusyBoard API. Jentic connects it directly from the API Directory: import it, store your key once, and your agent can read availability and find free times straight away, with no extra server to run and no tool definitions loaded into the agent's context. ### Can I limit what my agent is allowed to do with the BusyBoard API? Yes. You choose which operations your agent may call, so you can allow reading availability and finding mutual times while leaving the meeting-proposal operation out, and every call it makes is logged. That keeps a read-only scheduling agent from proposing meetings on its own. ### What authentication does the BusyBoard API use? The BusyBoard API authenticates with a bearer API key sent in the Authorization header per its OpenAPI spec, and a share link can also serve the same availability data without a key. Through Jentic the key is stored encrypted by your own instance and added to each request at call time. ### Can I find a time that works for a whole group with the BusyBoard API? Yes. The find-time operation returns mutual free windows across several people for a date range and a requested duration, so an agent can hand back a slot that works for everyone without reading each person's calendar. ### What are the rate limits for the BusyBoard API? The OpenAPI spec does not specify rate limits for the BusyBoard API. For current limits, see the BusyBoard documentation at https://busyboard.app. ### How do I find a meeting time with the BusyBoard API through Jentic? Import the BusyBoard API from the Jentic API Directory, then have your agent issue a request such as 'find a free time for this group next week'. Jentic matches the intent to the find-time operation and returns its input schema so the agent builds a valid request, with your stored key injected at call time. To run it on your own infrastructure, install Jentic One from its GitHub repo.