# Source: https://linear.app/developers/integration-directory.md

# Source: https://linear.app/docs/integration-directory.md

# Integration Directory

Discover Linear add-ons or build your own

![Linear icon next to integration icon](https://webassets.linear.app/images/ornj730p/production/b29db83e0238c6adea3c3a6d86834734fe332f29-2880x1620.png?q=95&auto=format&dpr=2)

## Overview

Linear's [Integration Directory](https://linear.app/integrations) features apps and add-ons created by the Linear team as well as external applications. Install these to improve your workflow and sync with your favorite tools. You can also build your own integrations and submit them to the directory.

## Basics

### Linear crafted

If you see an integration with a star badge on the icon, that means it was crafted by the Linear team. You can install them via the link in the directory or by going to [_Settings > Workspace > Integrations_](https://linear.app/settings/integrations/github) and then select the integration name. 

For most integrations, you'll have to be a workspace admin to install them for your workspace. If you don't know who is an admin, go to [_Settings > Workspace > Members_](https://linear.app/settings/members) and filter for Admins.

### Third-party integrations

The directory also features integrations built by other apps and third parties. We recommend doing your own research into the integration owner and permissions required before installing these integrations. You can find the creator's website and contact in the sidebar. 

### Build your own

Use [Linear's API](https://developers.linear.app/docs/) to build your own integration and submit it to the directory following the instructions below. We recommend building applications using [OAuth](https://developers.linear.app/docs/oauth/authentication) and having a separate workspace for the application, which gives all admins access to the application (instead of only the application creator).

We'll accept integrations that we think are useful to the community and are built by formal companies. We generally do not accept scripts or apps built by hobbyists, but feel free to reach out to [integrations@linear.app](mailto:integrations@linear.app) if you think it should be included. You can also ask questions and see what others are building in our Slack community's [#api channel](https://linear.app/join-slack).

![Figma file screenshot of Linear integration template](https://webassets.linear.app/images/ornj730p/production/597944e28167f567525f4b602ad72c3db65a973d-1504x933.png?q=95&auto=format&dpr=2)

### Submit your integration

1. Fill out this [form](https://docs.google.com/forms/d/e/1FAIpQLSdYKtml_JsVv-sXuP4_eiT-l-8K6IaoEQrxdAP_7w-mb1-hSQ/viewform?usp=sf_link). It includes a sample page to give you a sense of copy style and length.
2. Submit assets to integrations@linear.app or include a link in the form. We've built a [template in Figma](https://www.figma.com/community/file/1111754695287344546) to make this easy.
3. Send any questions to [integrations@linear.app](mailto:integrations@linear.app)