Skip to main content

What’s supported

Supported actions

This connector supports:

Supported Objects

The Linear connector supports reading to the following objects: The Linear connector supports writing to the following objects:

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. Enter the Application name, Developer name and Developer URL in the respective sections.
  6. Enter the Ampersand Callback URLs: https://api.withampersand.com/callbacks/v1/oauth in the Callback URLs section.
  7. [Optional] Enable the Public option if you wish to allow this app to be installed by other workspaces. Linear OAuth Creation

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. Ampersand Project Selection
  3. Select Provider Apps.
  4. Select Linear from the Provider list.
  5. Enter the previously obtained Client ID in the Client ID field and the Client Secret in the Client Secret field.
  6. For Scopes you can start with write (which grants the app write access to all objects) or use more targeted scopes issues:create or comments:create.
Check Linear’s documentation for more details.
Ampersand Integration 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.
I