| Linear | Projects and activities | Planning and tasks |
|---|---|---|
| Project | Project | Task |
| Issue | Subproject | Sub-task |
Before you start
You need administrative privileges in both Linear and Beebole to set up the integration.
| What syncs from Linear | What stays in Beebole |
|---|---|
| Projects: Imported as Beebole projects or tasks. | Approval workflows: Beebole handles the timesheet lifecycle. |
| Issues: Imported as Beebole subprojects or sub-tasks. | Billing rates: Managed exclusively in Beebole. |
| Members: Linear active members are mapped as Beebole people. | Budgets: Set within Beebole’s billing and budget settings. |
What’s included
Linear projects and issues
Linear projects and issues
Active projects and issues at the time of enabling the integration are created in Beebole. Any name change to those items is reflected in Beebole while the integration is active. New projects and issues created in Linear are also automatically added to Beebole.
Linear members
Linear members
All active members in your Linear workspace are automatically created as people in Beebole when you first enable the integration. You choose a default role for these imported employees during setup.
Items managed in Beebole
Items managed in Beebole
Timesheet entries, approval workflows, billing rates, budgets, and expenses remain in Beebole and are not affected by the integration.
Step-by-step configuration
Connect to Linear
Go to Settings > Integrations > Linear. Click Connect to Linear.Follow the instructions in the popup to authorize Beebole to access your Linear workspace. The popup closes automatically when the connection is complete.
Connect to Linear
Go to Settings > Integrations > Linear. Click Connect to Linear.Follow the instructions in the popup to authorize Beebole to access your Linear workspace. The popup closes automatically when the connection is complete.
Configure integration parameters
Once connected, configure the following options:
- Where to import your tasks — Choose between Projects and activities (for project time tracking with rates and billing) or Planning and tasks (for resource planning and assignment).
- Default role for imported employees — Select the role to assign to Linear members when they are imported into Beebole.
Configure integration parameters
Once connected, configure the following options:
- Where to import your tasks — Choose between Projects and activities (for project time tracking with rates and billing) or Planning and tasks (for resource planning and assignment).
- Default role for imported employees — Select the role to assign to Linear members when they are imported into Beebole.
Enable the integration
Click the toggle to Enable integration. Beebole imports all your active Linear projects and issues.Once complete, the integration is active. All future changes in Linear are automatically reflected in Beebole.
The initial import may take a few moments depending on the size of your Linear workspace. You can continue using Beebole while the import runs in the background.
Enable the integration
Click the toggle to Enable integration. Beebole imports all your active Linear projects and issues.Once complete, the integration is active. All future changes in Linear are automatically reflected in Beebole.
The initial import may take a few moments depending on the size of your Linear workspace. You can continue using Beebole while the import runs in the background.
Validate the integration
Click the Projects icon in the left menu to open the Projects page. Expand the categories — you should see a new category called Linear containing all your imported projects and issues. You can rename this category if needed.
Validate the integration
Click Projects in the sidebar to open the Projects page. Expand the categories — you should see a new category called Linear containing all your imported projects and issues. You can rename this category if needed.
Configure the timesheet
If you want the new Linear category to appear in the timesheet, go to Settings > Account Settings > Timesheet Settings and select the Linear category.
Disabling the integration
To disable the integration, go to Settings > Integrations > Linear and toggle the integration off. You can re-enable it at any time to resume syncing. To disconnect your Linear account entirely, click Reset connection.Related content
Projects and activities
Manage your projects, subprojects, and billing rates in Beebole.
Planning and tasks
Create, organize, and assign tasks, and track time against them.
Custom integrations
Build your own integrations using the Beebole GraphQL API.
All integrations
Explore all available Beebole integrations.
Frequently asked questions
What is the difference between Projects and activities and Planning and tasks?
What is the difference between Projects and activities and Planning and tasks?
Beebole’s time management has two structures. Projects and activities can be configured with billing rates, costs, budgets, and expenses. Planning and tasks is a list of tasks you can assign in resource planning charts. Both can be used in the timesheet to track time. Choose the option that best fits how your organization manages work.
How often does Beebole sync with Linear?
How often does Beebole sync with Linear?
Changes made in Linear (new projects, issues, or name updates) are reflected in Beebole automatically. In most cases this happens within minutes. If a change is not reflected within 24 hours, contact support@beebole.com.
Can I choose which Linear projects to import?
Can I choose which Linear projects to import?
The integration imports all active projects and issues from your Linear workspace. You cannot selectively import individual projects. However, you can organize and filter imported items within Beebole after the import.
What happens to imported data if I disable the integration?
What happens to imported data if I disable the integration?
All previously imported projects, issues, and people remain in Beebole as local records. They are not deleted. Only future changes from Linear will stop syncing until you re-enable the integration.
Do I need admin access in both Linear and Beebole?
Do I need admin access in both Linear and Beebole?
Yes. You need administrative privileges in both your Linear workspace and your Beebole account to set up and configure the integration.