Skip to main content

How to add Linear to Coworker

How to Linear as a connected data source to Coworker

Updated over 4 months ago

ℹ Only Network Admins can add data sources to Coworker. Contact your network admin for assistance

ℹ You must be an admin for the connected data source in order to successfully connect the tool to Coworker. If you do not have admin access for this tool, you will need to either obtain admin privileges for the tool otherwise add an admin of that tool as an admin on Coworker so they can complete the connection

Prerequisites

  • A Linear account with sufficient access to the workspace & projects you wish to sync with Coworker Labs.

Generating the credentials

  1. Go to https://linear.app/settings/account/security to start the api key process. Note: Make sure you're on the correct workspace.

    • Alternatively, go to https://www.linear.app and navigate to the workplace settings in the top left corner. Then, navigate to the Security & access section.

Navigating to workplace settings

2. Create a new API key. First give it a label like "coworker-integration", then click "Create new API key".

Generating API key

IMPORTANT: Your API key is automatically copied to your clipboard once it's created. You won't be able to view it later, so please save it somewhere secure now.

Information required for the Coworker connection:

  • auth_token: The personal API key you generated earlier

  • start_date: Date of the first record to synchronize, in a ISO8601 format (eg. 2024-01-01)

  • workspace_name: Workspace identifier, used in your workspace URL (ie. linear.app/[my-workspace] -> my-workspace)

ℹ You must share your token and credentials via a secure app like 1Password or LastPass. This is for SOC2 compliance and to protect your data

Did this answer your question?