Linear
Create issues, list teams, and manage projects in Linear.
On this page
Connect
Auth type: OAuth (oauth2). Click Connect and approve access on the provider's page. Appbricx runs the OAuth flow (signed single-use state, PKCE where the provider supports it), stores the tokens encrypted and refreshes them before they expire.
Scopes requested: readwrite
OAuth needs an OAuth app: the platform's when the operator configured one, or your own (admin panel, Integrations, Configure). You can also bring your own credentials.
- In the editor: Backend panel, Integrations tab, then Connect. This connects it for the project.
- For every project in a workspace: Workspace settings, Integrations.
- Owners and admins choose which integrations members may connect in the admin panel (Integrations tab), and can attach their own OAuth app there.
Call it from a workflow
Pass the action name and its input. The call resolves with { success, output, error? }; a missing connection resolves with success false and the reason. See ctx.integrations.invoke and ctx.integrations.call.
// .workflow.js (native ctx)
export async function run(ctx) {
const res = await ctx.integrations.invoke("linear", "linear_create_comment", {
"team_id": "<team_id>",
"issue_id": "<issue_id>",
"body": "<comment body>"
});
if (!res.success) throw new Error(res.error);
ctx.log.info("Linear answered", { output: res.output });
}// defineWorkflow module (@app/sdk ctx)
import { defineWorkflow } from "@app/sdk";
export default defineWorkflow({
id: "linear-linear-create-comment",
name: "Linear: Create Comment",
description: "Calls Linear when a row is created.",
trigger: { type: "entity_event", entity: "tickets", event: "created" },
async run(ctx, event) {
const res = await ctx.integrations.call("linear", {
"action": "linear_create_comment",
"team_id": "<team_id>",
"issue_id": "<issue_id>",
"body": "<comment body>"
}) as { success: boolean; error?: string };
if (!res.success) throw new Error(res.error);
},
});curl -X POST "$APP_ORIGIN/__appbricx/connector-proxy/linear/linear_create_comment" \
-H "Authorization: Bearer $APP_KEY" \
-H "content-type: application/json" \
-d '{"props":{"team_id":"<team_id>","issue_id":"<issue_id>","body":"<comment body>"}}'Actions
linear_create_commentin catalog
Create Comment. Create a new comment on an issue in Linear workspace
Also accepted as create_comment.
| Input | Type | Description |
|---|---|---|
team_idrequired | id (picked from your account) | The team for which the issue, project or comment will be created |
user_idoptional | id (picked from your account) | Assignee of the Issue / Comment |
issue_idrequired | id (picked from your account) | ID of Linear Issue |
bodyrequired | long text | The content of the comment |
linear_create_issuein catalog
Create Issue. Create a new issue in Linear workspace
Also accepted as create_issue.
| Input | Type | Description |
|---|---|---|
team_idrequired | id (picked from your account) | The team for which the issue, project or comment will be created |
titlerequired | text | Title |
descriptionoptional | long text | Description |
state_idoptional | id (picked from your account) | Status of the Issue |
labelsoptional | ids (picked from your account) | Labels for the Issue |
assignee_idoptional | id (picked from your account) | Assignee of the Issue / Comment |
priority_idoptional | id (picked from your account) | Priority of the Issue |
template_idoptional | id (picked from your account) | ID of Template |
linear_update_issuein catalog
Update Issue. Update a issue in Linear Workspace
Also accepted as update_issue.
| Input | Type | Description |
|---|---|---|
team_idrequired | id (picked from your account) | The team for which the issue, project or comment will be created |
issue_idrequired | id (picked from your account) | ID of Linear Issue |
titleoptional | text | Title |
descriptionoptional | long text | Description |
state_idoptional | id (picked from your account) | Status of the Issue |
labelsoptional | ids (picked from your account) | Labels for the Issue |
assignee_idoptional | id (picked from your account) | Assignee of the Issue / Comment |
priority_idoptional | id (picked from your account) | Priority of the Issue |
linear_create_project
Create Project. Create a new project in Linear workspace
| Input | Type | Description |
|---|---|---|
team_idrequired | id (picked from your account) | The team for which the issue, project or comment will be created |
namerequired | text | Project Name |
descriptionoptional | long text | Description |
iconoptional | text | Icon |
coloroptional | text | Color |
startDateoptional | date-time (ISO) | Start Date |
targetDateoptional | date-time (ISO) | Target Date |
stateoptional | one of "backlog" | "planned" | "started" | "paused" | "completed" | "canceled" | The status of the project |
linear_update_project
Update Project. Update a existing project in Linear workspace
| Input | Type | Description |
|---|---|---|
team_idrequired | id (picked from your account) | The team for which the issue, project or comment will be created |
project_idrequired | id (picked from your account) | ID of Linear Project |
namerequired | text | Project Name |
descriptionoptional | long text | Description |
iconoptional | text | Icon |
coloroptional | text | Color |
startDateoptional | date-time (ISO) | Start Date |
targetDateoptional | date-time (ISO) | Target Date |
stateoptional | one of "backlog" | "planned" | "started" | "paused" | "completed" | "canceled" | The status of the project |
rawGraphqlQuery
Raw GraphQL query. Perform a raw GraphQL query
| Input | Type | Description |
|---|---|---|
queryrequired | long text | Query |
variablesoptional | object | Parameters |
Details
- Id
linear- Category
- Project management
- Tags
- issues, project-management, engineering, agile
- Package
@activepieces/piece-linear@0.3.0- Tier
- Built in