# Beebole Documentation

## Docs

- [Export a Month of Time Records](https://beebole.com/help/api/examples/example-1.md): End-to-end Beebole GraphQL example: authenticate, query getTimeRecords with a typed filter and date window, and read durations in milliseconds.
- [Log Time Entries Programmatically](https://beebole.com/help/api/examples/example-2.md): End-to-end Beebole GraphQL example: add a time record with a millisecond duration, adjust it, clone a week, and submit the timesheet for approval.
- [API Documentation](https://beebole.com/help/api/introduction.md): Get started with the Beebole GraphQL API: how the endpoint works, how to authenticate with an API key, and how to send your first query or mutation.
- [GraphQL Mutations to Create and Update](https://beebole.com/help/api/mutations.md): Reference for Beebole GraphQL mutations: log time and expenses, submit and approve timesheets, and manage people, projects, tasks, and organization settings.
- [Querying time records, projects, and people](https://beebole.com/help/api/queries.md): Reference for Beebole GraphQL queries — read organizations, people, projects, tasks, tags, time records, and expenses, with typed filter inputs.
- [GraphQL Schema Explorer & Introspection](https://beebole.com/help/api/schema-explorer.md): Explore the Beebole GraphQL schema with introspection — connect a GraphQL client to the endpoint to browse types, queries, mutations, and field docs.
- [Account settings for your organization](https://beebole.com/help/documentation/account-settings.md): Configure your Beebole organization's defaults from Account Settings: localization, billing, cost, public holidays, work schedule, SSO, and more.
- [Time-off accruals: frequency and carry-forward](https://beebole.com/help/documentation/accruals.md): Configure time-off accrual policies in Beebole: choose accrual frequency, set carry-forward limits, and control when allowances are awarded.
- [Timesheet and time off approval workflows](https://beebole.com/help/documentation/approval.md): Set up multi-stage timesheet approval in Beebole: configure approval stages and quorum, approve or reject submissions, and follow up with reminders.
- [Assignments: control who has access to what](https://beebole.com/help/documentation/assignments.md): Control which projects, time off types, and expense types each person can use in Beebole — set account-wide defaults and who has access to each item.
- [Audit trail: track every change in your account](https://beebole.com/help/documentation/audit-trail.md): Beebole's audit trail records who changed what and when, surfaced in the Journal feed and as a Logs view on individual records.
- [Sign-in, passkeys, SSO, and API keys](https://beebole.com/help/documentation/authentication.md): How signing in to Beebole works: one-time email codes, passkeys, Google and Microsoft sign-in, single sign-on (SSO), API keys, and admin sign-in as.
- [Billing rates: turn tracked time into revenue](https://beebole.com/help/documentation/billing.md): Set billing rates in Beebole at the organization, tag, project, or person level and turn tracked hours into billable amounts in reports.
- [Project budgets: billing, cost, and hours targets](https://beebole.com/help/documentation/budgets.md): Set and track budgets on projects and subprojects in Beebole to monitor hours, costs, and billing against your targets and catch overruns early.
- [Key concepts: projects, people, tasks, and tags](https://beebole.com/help/documentation/concepts.md): Understand how Beebole is structured — projects, people, tasks, and tags — and how rates, schedules, and platform features connect them.
- [Cost rates: track labor costs and margins](https://beebole.com/help/documentation/costs.md): Define cost rates in Beebole for your organization, tags, projects, and people to track labor costs and measure project margins in reports.
- [Custom fields: capture extra data on your work](https://beebole.com/help/documentation/custom-fields.md): Create custom fields in Beebole to capture extra data on people, projects, tasks, and time records — six field types with validation and visibility rules.
- [Custom reports: columns, charts, and matrix](https://beebole.com/help/documentation/custom-reports.md): Build custom reports in Beebole — add columns for time, billing, and costs, group and filter data, and view results as a table, chart, or matrix.
- [Exporting Report Data to CSV, Excel, and PDF](https://beebole.com/help/documentation/data-exports.md): Export Beebole report data as Excel, CSV, PDF, JSON, and more for offline analysis, payroll processing, or sharing with clients and stakeholders.
- [Excel Add-in: Link Sheets to Saved Reports](https://beebole.com/help/documentation/excel-addin.md): Link Excel worksheets to your saved Beebole reports and refresh time tracking, billing, and project data with one click — no manual exports.
- [Expense tracking: categories, records, and reports](https://beebole.com/help/documentation/expenses.md): Track project and employee expenses in Beebole — create expense categories, log amounts or quantities, and report on spending alongside time.
- [Gantt chart: scheduling tasks on a timeline](https://beebole.com/help/documentation/gantt.md): Schedule tasks on Beebole's Gantt chart — drag bars to set dates, link dependencies, customize columns, and spot overload with the workload heatmap.
- [Google Sheets Add-on: Link Sheets to Reports](https://beebole.com/help/documentation/gsheets-addon.md): Link Google Sheets to your saved Beebole reports and refresh time tracking, billing, and project data from a sidebar — no manual exports.
- [Journal: Team Activity Feed & Messaging](https://beebole.com/help/documentation/journal.md): Use the Journal in Beebole as your team's activity feed — view updates, exchange messages, and stay informed about what's happening across your account.
- [Kanban board: moving tasks through statuses](https://beebole.com/help/documentation/kanban.md): Move task cards between status columns on Beebole's Kanban board, set hard WIP limits per status, select multiple cards, and start time records from a card.
- [Legacy Migration — Import Your Old Data into Beebole](https://beebole.com/help/documentation/legacy-migration.md): Import your existing Beebole data — people, projects, time records, and settings — into the current platform with the one-time Legacy Migration tool.
- [Mobile and Desktop App for Time Tracking](https://beebole.com/help/documentation/mobile.md): Install Beebole as a progressive web app on your phone, tablet, or desktop and use the responsive layout, dark mode, and on-the-go time tracking.
- [Notifications: Email & Push Alerts and Reminders](https://beebole.com/help/documentation/notifications.md): Set up email and push notifications in Beebole for mentions, approval updates, budget threshold alerts, and timesheet reminders — instant, daily, or weekly.
- [People: add, invite, and manage your team](https://beebole.com/help/documentation/people.md): Add, invite, and manage your team members in Beebole. Configure profiles, assign roles, and set up schedules and rates for each person.
- [Task planning: create, organize, and track tasks](https://beebole.com/help/documentation/planning.md): Tasks in Beebole are independent planning entities. Create them one by one or from a spreadsheet, organize statuses and subtasks, assign owners, and track time.
- [Managing projects and project categories](https://beebole.com/help/documentation/projects.md): Create projects and subprojects in Beebole, organize them into categories, add many at once from a spreadsheet, and control rates, budgets, and access.
- [Public holidays: country calendars and custom days](https://beebole.com/help/documentation/public-holidays.md): Set up country-specific public holiday calendars and add custom or regional holidays for your team in Beebole to streamline absence and capacity planning.
- [Quickstart: set up your time tracking account](https://beebole.com/help/documentation/quickstart.md): Set up Beebole in six steps — create your account, add your first project and team, track time, run a report, and adjust key settings.
- [Reports: analyze time, billing, and costs](https://beebole.com/help/documentation/reports.md): Run reports in Beebole to analyze tracked time, billing, costs, and budgets — filter and group data, schedule email delivery, and export results.
- [Roles and permissions: control who sees what](https://beebole.com/help/documentation/roles-authorisations.md): Create roles in Beebole and set Edit and View permissions for timesheets, billing, time off, reports, and more, each scoped to the right people.
- [Subscription, plans, seats, and billing](https://beebole.com/help/documentation/subscription.md): Manage your Beebole subscription: compare the Free, Essential, and Advanced plans, adjust seats, switch billing intervals, add add-ons, and manage payments.
- [Tags: organize people, projects, and tasks](https://beebole.com/help/documentation/tags.md): Group people, projects, and tasks in Beebole with hierarchical tags — departments, teams, locations — and cascade schedules, rates, and approvals through them.
- [Time off: absence types, allowances, and balances](https://beebole.com/help/documentation/timeoff.md): Configure absence types, set quotas, track balances, and manage vacation, sick leave, and other time-off requests for your team in Beebole.
- [Timesheet settings: configuring time entry](https://beebole.com/help/documentation/timesheetSettings.md): Configure the Beebole timesheet for your team: period and auto-submit, entry restrictions, time entry unit and timer, categories, and reminders.
- [Timesheets: tracking and submitting your time](https://beebole.com/help/documentation/timesheets.md): Track time in Beebole's timesheet: add rows for projects, tasks, or time off, enter hours or run a timer, copy periods, and submit for approval.
- [Work schedules: define and assign work patterns](https://beebole.com/help/documentation/work-schedule.md): Define work schedules in Beebole — weekly or longer cycles — and assign them at the organization, tag, or person level, each from its own start date.
- [Employee Guide: track and submit your time](https://beebole.com/help/guides/employee.md): A Beebole guide for employees: log your hours on the timesheet, record time off, submit your week for approval, and track time from the mobile app.
- [Frequently Asked Questions and Support](https://beebole.com/help/guides/faq.md): Answers to common Beebole questions about timesheets, projects, time off, reports, billing, integrations, mobile access, and account administration.
- [Moving to the New Beebole Platform](https://beebole.com/help/guides/migration.md): A guide for existing Beebole customers moving to the new platform: how the two systems coexist, how to test the new app, and what has changed.
- [Project Manager Guide: plan and run projects](https://beebole.com/help/guides/project-manager.md): A Beebole guide for project managers: set up projects and categories, plan tasks on Gantt and Kanban, set rates and budgets, run reports, and approve time.
- [Team Leader Guide: manage and approve your team](https://beebole.com/help/guides/team-leader.md): A Beebole guide for team leaders: add and invite people, assign roles and work schedules, approve timesheets and time off, and monitor team compliance.
- [Beebole Documentation](https://beebole.com/help/index.md): Find everything you need to set up, configure, and use Beebole for project time tracking. Guides for administrators, managers, and employees.
- [Asana integration: import projects and tasks](https://beebole.com/help/integrations/asana.md): Import Asana projects, tasks, and sub-tasks into Beebole for time tracking. Automatic webhook-based sync keeps your Asana workspace and Beebole account in sync.
- [BambooHR Approved Time-Off Sync Integration](https://beebole.com/help/integrations/bamboohr.md): Sync BambooHR time-off requests to Beebole absences. Connect your BambooHR account to automatically import approved leave into Beebole.
- [Custom Integrations via GraphQL API](https://beebole.com/help/integrations/custom-integrations.md): Build custom integrations with Beebole using the GraphQL API. Read and write your account data programmatically to connect Beebole to any tool.
- [Sign in to Beebole with Google — SSO and Domain Links](https://beebole.com/help/integrations/google.md): Sign in to Beebole with a Google account, link your Google Workspace domains, auto-provision people, and require Google sign-in across your organization.
- [Google Calendar Time Tracking Integration](https://beebole.com/help/integrations/google-calendar.md): Connect Google Calendar to your Beebole timesheet to see your events for the week and turn them into time entries with a click or a drag.
- [Integrations: Connect Your Tools](https://beebole.com/help/integrations/introduction.md): Connect Beebole with Asana, Jira, Linear, Monday.com, BambooHR, QuickBooks, Xero, and webhooks to keep projects, people, and time data in sync.
- [Jira integration: import projects and issues](https://beebole.com/help/integrations/jira.md): Connect Jira Cloud to Beebole to import projects and issues for time tracking. Automatic sync keeps your Jira Cloud site aligned with Beebole.
- [Linear integration: import projects and issues](https://beebole.com/help/integrations/linear.md): Connect Linear to Beebole to import projects and issues for time tracking. Automatic sync keeps your Linear workspace aligned with Beebole in real time.
- [Sign in to Beebole with Microsoft — SSO and Sign-In](https://beebole.com/help/integrations/microsoft.md): Sign in to Beebole with a Microsoft account and require Microsoft sign-in across your organization from the Single Sign-On panel of Account Settings.
- [Microsoft Outlook Calendar Time Tracking](https://beebole.com/help/integrations/microsoft-calendar.md): Connect Microsoft Calendar to your Beebole timesheet to see your Outlook events for the week and turn them into time entries with a click or a drag.
- [Monday.com integration: import boards and items](https://beebole.com/help/integrations/monday.md): Connect Monday.com to Beebole to import boards and items for time tracking. Automatic sync keeps your Monday.com workspace aligned with Beebole projects.
- [QuickBooks Online Time Tracking Integration](https://beebole.com/help/integrations/quickbooks.md): Connect Beebole to QuickBooks Online: import customers, items, and employees into Beebole, then export time entries as QuickBooks time activities in one click.
- [Outgoing Webhooks for Real-Time Notifications](https://beebole.com/help/integrations/webhooks.md): Configure outgoing webhooks in Beebole to receive real-time notifications when data changes. Signed POST requests with HMAC-SHA256 and automatic retry.
- [Xero Accounting and Invoicing Integration](https://beebole.com/help/integrations/xero.md): Connect Beebole to Xero to import your Xero contacts and items as projects, keep them in sync, and export tracked time and expenses as Xero invoices.
- [Product updates: new features and improvements](https://beebole.com/help/news/releases.md): Stay up to date with new features, improvements, and changes to Beebole. Monthly updates on integrations, reports, workflows, and more.

## OpenAPI Specs

- [openapi](https://beebole.com/api-reference/openapi.json)

## Optional

- [Contact us](mailto:support@beebole.com)
- [Ask our Community](https://www.reddit.com/r/beebole/)