Overview
Butlr turns privacy-first sensing data into occupancy, activity, and operational intelligence that organizations can use in different ways.
Some teams access Butlr data directly in the Butlr Web App. Others connect Butlr data to existing systems through APIs, webhooks, and integrations. The right access method depends on your workflow, audience, technical resources, and deployment goals.
Butlr data can typically be accessed through three main paths:
- Dashboards and standard reports in the Butlr Web App
- APIs and webhooks for programmatic access
- Integrations and connected workflows with third-party systems
Some advanced reports, custom workflows, integrations, and solution modules may require additional enablement, configuration, scoping, or services.
Available data, features, and access methods may vary depending on your deployment, account permissions, enabled modules, commercial agreement, and integration configuration.
Feature Availability and Add-Ons
Not all data views, reports, integrations, or workflow modules are enabled by default.
Available features may vary based on:
- Deployment type
- Hardware configuration
- Account permissions
- Enabled product modules
- Integration setup
- Commercial agreement or scope of work
Some advanced capabilities, such as customized insight reports, custom integrations, automation workflows, or solution modules like smart cleaning or energy optimization, may require additional scoping, configuration, or services.
If you are unsure whether a feature is included in your account, contact your Butlr representative or support team.
1. Dashboards, Standard Reports, and Custom Insights
The Butlr Web App is the easiest way for most users to view and understand Butlr data.
Dashboards and standard reports are designed for users who want to explore occupancy trends, monitor workplace activity, review utilization, or share insights with stakeholders without building a custom integration.
For deeper analysis, Butlr may also support customized insight reports or advisory deliverables. These are typically scoped separately and may not be included by default.
Best for
- Workplace and real estate teams
- Facilities and operations teams
- Customer administrators
- Business stakeholders
- Teams that need visual reporting and recurring insights
Common workflows
Dashboards, standard reports, and custom insights may help teams:
- Monitor live occupancy
- Review historical utilization
- Compare spaces, rooms, floors, or buildings
- Identify high-traffic or underused areas
- Track workplace trends over time
- Share standard reports or scoped insight deliverables with internal stakeholders
- Support planning and operational decisions
Examples
A workplace team may use dashboards to understand which meeting rooms are most used.
A facilities team may review traffic trends to plan cleaning schedules.
A real estate team may use reports to support portfolio planning or space optimization.
A leadership team may request a customized insight report to support a specific workplace strategy, real estate, or operational planning initiative.
2. APIs and Webhooks
APIs and webhooks allow technical teams to access Butlr data programmatically and use it in their own systems, applications, and workflows.
This is useful when an organization wants Butlr intelligence to appear outside the Butlr Web App, such as in an internal dashboard, IWMS platform, BMS, custom analytics tool, or operational workflow.
Best for
- Developers
- Data teams
- Integration partners
- Enterprise IT teams
- Customers building custom applications
- Teams that want Butlr data inside existing systems
Common workflows
APIs and webhooks may support:
- Pulling occupancy data into a customer-owned platform
- Sending live occupancy events to external systems
- Triggering workflows based on occupancy or activity
- Connecting Butlr data to dashboards or BI tools
- Automating space, building, or operations workflows
- Combining Butlr data with other enterprise datasets
Examples
A customer may use the Butlr API to display occupancy data inside their own workplace platform.
A building operations team may use webhooks to trigger workflows when occupancy changes.
A data team may combine Butlr occupancy data with booking, badge, or space planning data for deeper analysis.
API access, webhook availability, rate limits, data fields, and integration support may vary by account configuration and commercial agreement.
Developer resources
Technical setup, authentication, endpoint details, and API examples are available in Developer Docs.
3. Integrations and Connected Workflows
Integrations connect Butlr data with third-party systems, operational platforms, or external devices. Integration availability depends on the systems involved, technical requirements, deployment configuration, and enabled services.
Integrations are different from APIs in one important way:
- APIs and webhooks are the technical interfaces for accessing or sending data.
- Integrations are implemented workflows or system connections built using those interfaces.
Some integrations send Butlr intelligence out to customer systems. Others bring external system data or third-party sensor data into Butlr to add operational context.
Outbound integrations
Outbound integrations send Butlr data to another system.
Common examples may include:
- Building Management Systems (BMS)
- HVAC systems
- IWMS platforms
- Booking systems
- Smart cleaning workflows
- Alerting systems
- Customer-owned applications
Inbound integrations
Inbound integrations bring external signals or context into the Butlr platform.
Examples may include:
- Select third-party sensing devices
- Building telemetry
- Vendor cloud integrations
- Operational system data
- Environmental or contextual data, where supported
Third-party sensors or devices may use their own gateway, vendor cloud, API, or direct integration path. They do not necessarily connect through Butlr Hive gateways.
Connected workflows
Connected workflows may combine Butlr data with other operational systems to support outcomes such as:
- Occupancy-aware HVAC automation
- Smart cleaning
- Space booking optimization
- Operational alerts
- Custom dashboards
- Building performance analysis
Integration availability depends on the systems involved, deployment requirements, supported configuration, and enabled modules.
Advanced solution modules
Some workflows may be packaged as advanced solution modules rather than standard platform features.
Examples may include:
- Smart cleaning workflows
- Energy optimization workflows
- Building automation workflows
- Custom operational reporting
- Custom insight reports
These modules may require additional configuration, integration work, or commercial scoping.
Choosing the Right Access Method
Use this guide to decide where to start.
Use dashboards and reports when you need to:
- View data quickly
- Share standard insights with business users
- Review workplace trends
- Monitor occupancy or utilization
- Avoid custom development
- Use custom reports or scoped insights when deeper analysis is needed
Use APIs and webhooks when you need to:
- Build custom applications
- Pull Butlr data into your own platform
- Automate workflows
- Trigger real-time events
- Combine Butlr data with other datasets
- Support developer-led integrations
Use integrations when you need to:
- Connect Butlr to an existing operational system
- Support BMS, HVAC, IWMS, booking, or alerting workflows
- Bring third-party system data into Butlr
- Operationalize Butlr insights across multiple tools
- Create end-to-end automation
- Enable advanced solution modules such as smart cleaning or energy optimization
Many organizations use more than one access method. For example, a workplace team may use dashboards for analysis, while the IT team uses APIs to send the same data into an internal workplace platform.
Common Data Types
Depending on your deployment and permissions, Butlr data may include:
- Occupancy data
- Traffic data
- Utilization metrics
- Room, zone, or floor-level trends
- Historical analytics
- Event or alert data
- Device and deployment status
- Space metadata
- Third-party or operational context, where supported
Data availability may vary by sensing mode, hardware type, deployment configuration, enabled product features, and account permissions.
Access and Permissions
Access to Butlr data is controlled by account configuration, roles, permissions, enabled modules, and integration setup.
Some users may only have access to dashboards. Others may have access to administrative tools, API credentials, reports, or integration settings.
Some advanced workflows, solution modules, or custom deliverables may require additional enablement or scoping before they are available in your account.
If you cannot see expected data or features, check with your Butlr administrator or contact the Butlr support team.
Getting Started Checklist
Use this checklist to determine the best way to access Butlr data.
1. Identify your primary use case
Decide whether you need to:
- View data in a dashboard
- Build an integration
- Automate a workflow
- Export data for analysis
- Connect to an existing system
- Request a custom insight report or advanced solution module
2. Identify your audience
Determine who will use the data:
- Workplace teams
- Facilities teams
- Real estate teams
- Care teams
- Developers
- Building operations teams
- External systems
3. Choose an access method
Select the best starting point:
- Use the Butlr Web App for dashboards and standard reports
- Use Developer Docs for APIs and webhooks
- Work with Butlr on integrations for connected workflows
- Contact Butlr for custom reports, advanced solution modules, or scoped services
4. Confirm permissions and enabled features
Make sure your account has access to the right organization, site, features, credentials, and enabled modules.
5. Validate the data
Before using data in operational workflows, confirm that the deployment, space setup, sensing mode, and data quality are appropriate for your use case.
Common Questions
Are all dashboards, reports, integrations, and solution modules included by default?
No. Available features depend on your deployment, account configuration, permissions, enabled modules, and commercial agreement.
Some advanced capabilities, such as customized insight reports, custom integrations, automation workflows, or solution modules like smart cleaning or energy optimization, may require additional scoping, configuration, or services.
Can I use Butlr data without using the Butlr Web App?
Yes. Some customers access Butlr data through APIs, webhooks, or integrations and display it in their own systems.
Are dashboards and APIs showing the same data?
They may use the same underlying platform data, but the format, timing, aggregation, and available fields may differ depending on the dashboard, API endpoint, sensing mode, and configuration.
Do third-party sensors connect through Butlr Hive gateways?
Not necessarily. Third-party devices may use their own gateway, vendor cloud, API, or direct integration path.
Can Butlr data trigger workflows in other systems?
Yes, depending on configuration. Butlr data may support workflows such as alerts, HVAC optimization, smart cleaning, room booking, or custom operational automation.
Where can developers learn more?
Developers should refer to Developer Docs for API authentication, endpoint details, webhooks, schemas, and integration examples.
Where to Go Next
Recommended next articles:
Getting Started with Workplace Intelligence
Understanding Butlr's Space Utilization Metrics
How Roles & Space Permissions Work
For questions about enabled features, advanced modules, custom reports, or integrations, contact your Butlr representative or support team.
Comments
Please sign in to leave a comment.