Skip to main content
Beebole’s Linear integration imports your Linear projects, issues, and team members into Beebole so your employees can track time against their Linear work. The integration keeps your Linear workspace and Beebole account in sync automatically — when a project or issue is created or renamed in Linear, the change is reflected in Beebole. Sync runs one way, from Linear to Beebole: Beebole doesn’t send time entries or edits back to Linear. You can import your Linear structure into Beebole’s Projects and activities for time tracking with costs, billing, and expenses, or into Planning and tasks for resource assignment.

​
Before you start

You need administrative privileges in both Linear and Beebole to set up the integration.

​
What’s included

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.
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.If a person with the same email address already exists in Beebole, Beebole links the Linear member to that person instead of creating a new one. Members who join your Linear workspace later are not imported by the automatic sync or by Manual sync.
Timesheet entries, approval workflows, billing rates, budgets, and expenses remain in Beebole and are not affected by the integration.

​
Step-by-step configuration

1

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.
2

Configure integration parameters

Once connected, configure the following options:
  • Default role for imported employees: select the role to assign to Linear members when they are imported into Beebole. Beebole preselects a role whose people only see their own profile, such as Employee. To pick another one, remove it from the field and choose a role from the list.
  • 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).
Both options are locked while the integration is enabled.
You can review and manage existing roles in Settings > Person Roles.
3

Enable the integration

Click the toggle to Enable integration. Beebole imports all your active Linear projects and issues.
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. Until it finishes, the panel shows Updating integration. Please wait…
Once complete, the integration is active. New and renamed projects and issues in Linear now appear in Beebole automatically. Other changes are applied when you run a manual sync.
4

Validate the integration

Click Projects in the sidebar, then click the category name next to the Projects: heading and pick the new Linear category. It contains all your imported projects and issues. If you imported into Planning and tasks, click Planning in the sidebar instead, then click the planning name at the top of the page and pick the new Linear planning. You can rename it if needed.
5

Configure the timesheet

If you want the new Linear category to appear in the timesheet, go to Settings > Account Settings and open the Timesheet and Planning Settings panel. On its Categories tab, add Linear under Record time on these project categories, or under Record time on these plannings if you imported into Planning and tasks. See timesheet categories for how these rows work.

​
Syncing Linear manually

To pull the latest changes from Linear on demand, go to Settings > Integrations > Linear and click Manual sync next to Manually sync Linear projects and issues. The button appears while the integration is enabled. A manual sync compares your Linear projects and issues with Beebole. It creates what is missing, applies renames, moves issues that changed parent, and unarchives items that are active again in Linear. Projects and issues that are completed, canceled, or deleted in Linear are deleted in Beebole, or archived when they are already in use. Completing, canceling, or deleting a project or issue in Linear doesn’t change Beebole until a manual sync runs. After the sync, Beebole shows the counts of items Created, Archived, Unarchived, Deleted, and Renamed, and lists anything it could not sync under Entries not synced.

​
Disabling the integration

If you disable the integration, any future changes made in Linear will no longer sync to Beebole. Previously imported data remains in Beebole as local records.
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. When you turn it back on, Beebole runs a full sync to catch up on the changes made in Linear in the meantime. To disconnect your Linear account entirely, turn the integration off first, then click Reset connection. The Reset connection button is disabled while the integration is enabled. Projects, issues, and people already imported stay in Beebole.

​
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

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.
Changes made in Linear (new projects, issues, or name updates) are reflected in Beebole automatically. In most cases this happens within minutes. Completed, canceled, or deleted projects and issues, and issues moved to another parent, are applied when you click Manual sync in the Linear integration settings, which also pulls any pending change right away. If a change is still not reflected, contact support@beebole.com.
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.
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.
Yes. You need administrative privileges in both your Linear workspace and your Beebole account to set up and configure the integration.