> ## Documentation Index
> Fetch the complete documentation index at: https://docs.withampersand.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Linear
## What's supported
### Supported actions
This connector supports:
* [Read Actions](/read-actions), including full historic backfill and incremental read.
* [Write Actions](/write-actions).
* [Proxy Actions](/proxy-actions), using the base URL `https://api.linear.app/graphql`.
### Supported Objects
The Linear connector supports reading to the following objects:
* [attachments](https://studio.apollographql.com/public/Linear-API/variant/current/explorer)
* [auditEntries](https://studio.apollographql.com/public/Linear-API/variant/current/explorer)
* [comments](https://studio.apollographql.com/public/Linear-API/variant/current/explorer)
* [customers](https://studio.apollographql.com/public/Linear-API/variant/current/explorer)
* [cycles](https://studio.apollographql.com/public/Linear-API/variant/current/explorer)
* [documents](https://studio.apollographql.com/public/Linear-API/variant/current/explorer)
* [favorites](https://studio.apollographql.com/public/Linear-API/variant/current/explorer)
* [initiatives](https://studio.apollographql.com/public/Linear-API/variant/current/explorer)
* [issues](https://studio.apollographql.com/public/Linear-API/variant/current/explorer)
* [notifications](https://studio.apollographql.com/public/Linear-API/variant/current/explorer)
* [projects](https://studio.apollographql.com/public/Linear-API/variant/current/explorer)
* [projectStatuses](https://studio.apollographql.com/public/Linear-API/variant/current/explorer)
* [teamMemberships](https://studio.apollographql.com/public/Linear-API/variant/current/explorer)
* [teams](https://studio.apollographql.com/public/Linear-API/variant/current/explorer)
* [triageResponsibilities](https://studio.apollographql.com/public/Linear-API/variant/current/explorer)
* [users](https://studio.apollographql.com/public/Linear-API/variant/current/explorer)
* [workflowStates](https://studio.apollographql.com/public/Linear-API/variant/current/explorer)
The Linear connector supports writing to the following objects:
* [attachments](https://studio.apollographql.com/public/Linear-API/variant/current/explorer)
* [comments](https://studio.apollographql.com/public/Linear-API/variant/current/explorer)
* [customers](https://studio.apollographql.com/public/Linear-API/variant/current/explorer)
* [cycles](https://studio.apollographql.com/public/Linear-API/variant/current/explorer)
* [documents](https://studio.apollographql.com/public/Linear-API/variant/current/explorer)
* [issues](https://studio.apollographql.com/public/Linear-API/variant/current/explorer)
* [projects](https://studio.apollographql.com/public/Linear-API/variant/current/explorer)
* [teams](https://studio.apollographql.com/public/Linear-API/variant/current/explorer)
### Example integration
For an example manifest file of an Linear integration, visit our [samples repo on Github](https://github.com/amp-labs/samples/blob/main/linear/amp.yaml).
## Before you get started
To connect Linear with Ampersand, you need [a Linear Account](https://linear.app/signup).
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](https://linear.app/login) 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.
## Add Your Linear App Info to Ampersand
1. Log in to your [Ampersand Dashboard](https://dashboard.withampersand.com).
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 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](https://linear.app/developers/oauth-2-0-authentication#redirect-user-access-requests-to-linear) for more details.
To start integrating with Linear:
* Create a manifest file using the [example](https://github.com/amp-labs/samples/blob/main/linear/amp.yaml).
* Deploy it using the [amp CLI](/cli/overview).
* If you are using Read Actions, create a [destination](/destinations).
* Embed the [InstallIntegration](/embeddable-ui-components#install-integration) UI component.
* Start using the connector!
* If your integration has [Read Actions](/read-actions), you'll start getting webhook messages.
* If your integration has [Write Actions](/write-actions), you can start making API calls to our Write API.
* If your integration has [Proxy Actions](/proxy-actions), you can start making Proxy API calls.