What’s supported
Supported actions
This connector supports:- Read Actions, including full historic backfill and incremental read.
- Write Actions.
- Proxy Actions, using the base URL
https://api.linear.app/graphql
.
Supported Objects
The Linear connector supports reading to the following objects:- attachments
- auditEntries
- comments
- customers
- cycles
- documents
- favorites
- initiatives
- issues
- notifications
- projects
- projectStatuses
- teamMemberships
- teams
- triageResponsibilities
- users
- workflowStates
Example integration
For an example manifest file of an Linear integration, visit our samples repo on Github.Before you get started
To connect Linear with Ampersand, you need a Linear Account. Once your account is created, you’ll need to create an app in Linear and obtain the following credentials from your app:- Client ID
- Client Secret
Creating a Linear App
Follow the steps below to create a Linear app.- Log in to your Linear account.
- Once logged in, Click the dropdown next to your workspace name in the top-left corner, then select Settings from the menu.
- Navigate to API menu under Administration section.
- Click New OAuth Application.
- Upload an icon for the application with a minimum resolution of 256x256 pixels.
- Enter the Application name, Developer name, Developer URL and Description in the respective sections.
-
Enter the Ampersand Callback URLs:
https://api.withampersand.com/callbacks/v1/oauth
in the Callback URLs section. - Enter the github username in the GitHub username section.
- Enable the Public option which leads to allow a application to be installed by other workspaces.
- Enable the Webhooks option to receive HTTP push notifications on a specified URL and then click Create button.

Add Your Linear App Info to Ampersand
- Log in to your Ampersand Dashboard.
-
Select the project where you want to create a Linear integration.
- Select Provider Apps.
- Select Linear from the Provider list.
-
Enter the previously obtained Client ID in the Client ID field, the Client Secret in the Client Secret field and scopes in the Scopes field.
- Create a manifest file using the example.
- Deploy it using the amp CLI.
- If you are using Read Actions, create a destination.
- Embed the InstallIntegration UI component.
- Start using the connector!
- If your integration has Read Actions, you’ll start getting webhook messages.
- If your integration has Write Actions, you can start making API calls to our Write API.
- If your integration has Proxy Actions, you can start making Proxy API calls.