Linear

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

The Linear connector supports writing to the following objects:

• attachments
• comments
• customers
• cycles
• documents
• issues
• projects
• teams

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

You will then use these credentials to connect your application to Ampersand.

Creating a Linear App

Follow the steps below to create a Linear app.

1. Log in to your Linear account.

2. Once logged in, Click the dropdown next to your workspace name in the top-left corner, then select Settings from the menu.

3. Navigate to API menu under Administration section.

4. Click New OAuth Application.

5. Upload an icon for the application with a minimum resolution of 256x256 pixels.

6. Enter the Application name, Developer name, Developer URL and Description in the respective sections.

7. Enter the Ampersand Callback URLs: https://api.withampersand.com/callbacks/v1/oauth in the Callback URLs section.

8. Enter the github username in the GitHub username section.

9. Enable the Public option which leads to allow a application to be installed by other workspaces.

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

1. Log in to your Ampersand Dashboard.

2. Select the project where you want to create a Linear integration.

   

3. Select Provider Apps.

4. Select Linear from the Provider list.

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

   

To start integrating with Linear:

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