About Beekeeper
Beekeeper is a mobile-first communication and operations platform for frontline workforces. It gives non-desk employees a single app for company news streams, chat, tasks, shift schedules, forms, and documents. Connecting Beekeeper to Serval lets your workflows reach frontline employees where they already work — sending messages, assigning tasks, managing shifts and events, and reading back submissions and profile data.What the Beekeeper integration enables
| Capability | Description |
|---|---|
| Communication | Create and manage stream posts and comments; send and read chat messages in group chats (Chats 2.0) |
| Users & profiles | List and manage users, profiles, and groups |
| Tasks | Create, assign, and track tasks, subtasks, and approvals; export task history |
| Shifts | Manage schedules and shifts, including bulk shift imports |
| Forms & surveys | Manage forms and read submissions; run surveys |
| Company events | Create events and manage audiences and invitees |
| Files | Manage artifacts (files and folders) and their access control lists |
| Workflows & webhooks | Inspect Beekeeper workflow definitions and executions; manage webhook subscriptions |
Beekeeper configuration
Prerequisites
- An active Beekeeper tenant (e.g.,
company.beekeeper.io) - Admin access to the Beekeeper dashboard with permission to manage bot accounts
Create a bot access token
Serval authenticates to Beekeeper with a bot account’s access token.Open the Beekeeper dashboard
Sign in to Beekeeper and click the speedometer icon on the right-hand side of the top navigation bar to open the admin dashboard.
Navigate to Bot Accounts
In the left navigation, open the Extensions tab, then select the Bot Accounts subtab.
Create a bot account
Click Add Bot and give it a descriptive name (e.g.,
Serval Integration). The bot’s name and avatar are what employees see when Serval posts or messages on its behalf.Beekeeper bot access tokens do not expire. To revoke Serval’s access, delete or regenerate the token in the Beekeeper dashboard.
Identify your subdomain
Your Beekeeper subdomain is the tenant-specific part of your Beekeeper URL. Forhttps://company.beekeeper.io, the subdomain is company. Serval uses it to build the base URL https://company.beekeeper.io/api/2/ for every API call.
Serval configuration
- In Serval, go to Apps → Available → Beekeeper → Connect
-
Enter the following:
Field Description Subdomain The tenant part of your Beekeeper URL (e.g., companyforcompany.beekeeper.io). Do not include.beekeeper.io.Access Token The bot access token created above. Serval sends it as Authorization: Token …on every request. - Click Save
Serval verifies the connection by calling Beekeeper’s authenticated
GET /api/2/status endpoint. If the healthcheck fails, double-check the subdomain spelling and that the token was copied with no extra characters.Installable workflows
The Beekeeper integration includes pre-built workflows you can install and use immediately:| Workflow | Description |
|---|---|
| Create Task | Create a new task in Beekeeper |
| Send Direct Message | Send a Beekeeper chat message to a user |
Additional resources
Beekeeper API documentation
Full REST API reference for the Beekeeper platform
Beekeeper Help Center
Admin guides, including bot account management
Need help? Contact support@serval.com for assistance with your Beekeeper integration.