Skip to main content
POST
/
integrations
/
linear
/
{conversation_id}
/
tickets
Create a new Linear issue and attach it to a conversation
curl --request POST \
  --url https://api.getfernand.com/integrations/linear/{conversation_id}/tickets \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "title": "Fix user authentication flow",
  "state": "8a7b93d1-18f7-4a9f-b5c6-3e2d1f9a8c7b",
  "team": "7b8c9d0e-1f2a-3b4c-5d6e-7f8a9b0c1d2e"
}
'
{
  "id": "8a7b93d1-18f7-4a9f-b5c6-3e2d1f9a8c7b",
  "title": "Fix user authentication flow",
  "url": "https://linear.app/team/issue/ENG-123",
  "identifier": "ENG-123",
  "assignee": {
    "name": "Richard Hendricks",
    "avatar_url": "https://avatar.linear.app/9c0d1e2f"
  },
  "state": {
    "name": "Todo",
    "type": "backlog",
    "color": "#e2e2e2",
    "verbose": "2024-01-15T10:30:00+00:00",
    "last_updated_at": "2024-01-15T10:30:00Z"
  },
  "labels": [
    {
      "name": "bug",
      "color": "#5e6ad2"
    }
  ],
  "priority": 1,
  "priority_label": "Urgent",
  "last_updated_at": "2025-01-15T10:30:00Z"
}
Creates a new Linear issue with the provided details and automatically attaches it to the specified conversation. An attachment and customer link are added to the issue linking it to the conversation in Fernand.

Authorizations

​
X-API-Key
string
header
required

Authenticate your account by including your secret key in API requests. You can manage your API keys in the Dashboard.

Authentication to the API is performed by using the HTTP Header X-API-Key.

Path Parameters

​
conversation_id
integer
required

ID of the conversation to attach the issue to.

Body

application/json
​
title
string
required

Title of the Linear issue (required, max 250 characters).

Example:

"Fix user authentication flow"

​
state
string
required

UUID of the workflow state for the issue (required).

Example:

"8a7b93d1-18f7-4a9f-b5c6-3e2d1f9a8c7b"

​
team
string
required

UUID of the team to create the issue in (required).

Example:

"7b8c9d0e-1f2a-3b4c-5d6e-7f8a9b0c1d2e"

​
description
string

Description of the issue in HTML or Markdown format (optional, max 250,000 characters, will be converted to Markdown).

Example:

"<p>Users are unable to log in with their credentials.</p>"

​
priority
integer

Priority level - 0 (No priority), 1 (Urgent), 2 (High), 3 (Medium), 4 (Low) (optional).

Example:

1

​
assignee
string

UUID of the user to assign the issue to (optional).

Example:

"9c0d1e2f-3a4b-5c6d-7e8f-9a0b1c2d3e4f"

​
labels
string[]

Array of label UUIDs to apply to the issue (optional).

Example:
["0d1e2f3a-4b5c-6d7e-8f9a-0b1c2d3e4f5a"]
​
project
string

UUID of the project to add the issue to (optional).

Example:

"1e2f3a4b-5c6d-7e8f-9a0b-1c2d3e4f5a6b"

Response

Linear issue created and attached successfully.

​
id
string

Unique identifier of the created Linear issue.

Example:

"8a7b93d1-18f7-4a9f-b5c6-3e2d1f9a8c7b"

​
title
string

Title of the issue.

Example:

"Fix user authentication flow"

​
url
string

URL to view the issue in Linear.

Example:

"https://linear.app/team/issue/ENG-123"

​
identifier
string

Human-readable issue identifier.

Example:

"ENG-123"

​
assignee
object

Assigned user (null if unassigned).

​
state
object

Current workflow state of the issue.

​
labels
object[]

List of labels applied to the issue.

​
priority
integer

Priority level (0=No priority, 1=Urgent, 2=High, 3=Medium, 4=Low).

Example:

1

​
priority_label
string

Display name of the priority level.

Example:

"Urgent"

​
last_updated_at
string

ISO 8601 timestamp of the last update.

Example:

"2025-01-15T10:30:00Z"