The Linear API together with webhooks lets you extend Linear's functionality beyond what we provide out of the box. For more in depth documentation visit developers.linear.app. Check out our Slack community to meet others building integrations and using the API.
Linear API
Welcome to Linear's developer docs, where you can learn more about Linear's API and developer tooling. You can use Linear's API to build everything from light scripts to complete integrations for the tool you're working on.
http://developers.linear.app
Our API
Linear's public API is built using GraphQL. It's the same API we use internally for developing our applications. You own your data in Linear and our GraphQL API lets you query all of that data. In addition to querying, Linear has full support for mutating all entities. Any mutations you make via the API are observed in real-time by all clients, giving you immense powers when writing your integrations.
How to use the API
Go to the API section under general settings and read the linked API documentation. Use the generator on that page to create personal API keys. This will let you query and update data available to your user account. For more information, see the API documentation: https://developers.linear.app/docs/graphql/working-with-the-graphql-api
Webhooks
Linear webhooks allow you to receive HTTP(S) push notifications whenever data is created or updated. This allows you to build integrations on top of Linear. Our current webhooks support issues and comments. We plan to support more data objects in the future. Some examples of how you can use this include to trigger CI builds, perform calculations on issue data or send messages on specific conditions. Read more about Linear Webhooks in our webhook documentation.
How to use webhooks
Read the documentation linked under API in general settings and then visit the team settings to configure webhooks. The configured URL will be called whenever any issue or comment in that team is created or updated. You'll receive the entire data object as the payload. We'll also let you know what the previous values for all changed properties were.
Integrations and apps made by the Linear Community
We published our API so that you can build integrations we don't offer. Please tweet and share any integrations you build in the #api channel in our Linear Customer Slack. We also welcome feature requests for integrations you think others will appreciate, too.