> ## Documentation Index > Fetch the complete documentation index at: https://developers.getfernand.com/llms.txt > Use this file to discover all available pages before exploring further. # Create a new Linear issue and attach it to a conversation 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. ## OpenAPI ````yaml https://api.getfernand.com/openapi.json post /integrations/linear/{conversation_id}/tickets openapi: 3.0.3 info: title: Fernand API Documentation version: '3.0' description: This is the documentation for the [Fernand](https://getfernand.com) API. termsOfService: https://getfernand.com/terms contact: name: Fernand Support url: https://getfernand.com email: support@getfernand.com x-logo: url: https://app.getfernand.com/images/favicon/icon_128.png servers: - url: https://api.getfernand.com description: '' x-last-modified: 1764750693905 security: - apiKeyHeader: [] externalDocs: description: You can access our documentation online by visiting https://api.fernand.help url: https://api.fernand.help paths: /integrations/linear/{conversation_id}/tickets: post: tags: - Linear Integration summary: Create a new Linear issue and attach it to a conversation description: >- 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. operationId: createLinearTicket parameters: - name: conversation_id in: path required: true schema: type: integer description: ID of the conversation to attach the issue to. example: 12345 requestBody: required: true content: application/json: schema: type: object properties: title: type: string description: Title of the Linear issue (required, max 250 characters). example: Fix user authentication flow description: type: string description: >- Description of the issue in HTML or Markdown format (optional, max 250,000 characters, will be converted to Markdown). example:

Users are unable to log in with their credentials.

state: type: string description: UUID of the workflow state for the issue (required). example: 8a7b93d1-18f7-4a9f-b5c6-3e2d1f9a8c7b team: type: string description: UUID of the team to create the issue in (required). example: 7b8c9d0e-1f2a-3b4c-5d6e-7f8a9b0c1d2e priority: type: integer description: >- Priority level - 0 (No priority), 1 (Urgent), 2 (High), 3 (Medium), 4 (Low) (optional). example: 1 assignee: type: string description: UUID of the user to assign the issue to (optional). example: 9c0d1e2f-3a4b-5c6d-7e8f-9a0b1c2d3e4f labels: type: array description: Array of label UUIDs to apply to the issue (optional). items: type: string example: - 0d1e2f3a-4b5c-6d7e-8f9a-0b1c2d3e4f5a project: type: string description: UUID of the project to add the issue to (optional). example: 1e2f3a4b-5c6d-7e8f-9a0b-1c2d3e4f5a6b required: - title - state - team responses: '200': description: Linear issue created and attached successfully. content: application/json: schema: type: object properties: id: type: string description: Unique identifier of the created Linear issue. example: 8a7b93d1-18f7-4a9f-b5c6-3e2d1f9a8c7b title: type: string description: Title of the issue. example: Fix user authentication flow url: type: string description: URL to view the issue in Linear. example: https://linear.app/team/issue/ENG-123 identifier: type: string description: Human-readable issue identifier. example: ENG-123 assignee: type: object description: Assigned user (null if unassigned). properties: name: type: string description: Display name of the assignee. example: Richard Hendricks avatar_url: type: string description: URL to the assignee's avatar image. example: https://avatar.linear.app/9c0d1e2f state: type: object description: Current workflow state of the issue. properties: name: type: string description: Name of the workflow state. example: Todo type: type: string description: Type of the workflow state. example: backlog color: type: string description: Color hex code of the workflow state. example: '#e2e2e2' verbose: type: string description: ISO 8601 timestamp verbose format. example: '2024-01-15T10:30:00+00:00' last_updated_at: type: string description: >- ISO 8601 timestamp of when the issue entered this state. example: '2024-01-15T10:30:00Z' labels: type: array description: List of labels applied to the issue. items: type: object properties: name: type: string description: Name of the label. example: bug color: type: string description: Color hex code of the label. example: '#5e6ad2' priority: type: integer description: >- Priority level (0=No priority, 1=Urgent, 2=High, 3=Medium, 4=Low). example: 1 priority_label: type: string description: Display name of the priority level. example: Urgent last_updated_at: type: string description: ISO 8601 timestamp of the last update. example: '2025-01-15T10:30:00Z' '400': description: Invalid input or error creating issue at Linear. content: application/json: schema: type: object properties: error: type: string example: Invalid state ID '404': description: Linear integration or conversation not found. '502': description: Error occurred at Linear while creating the issue. content: application/json: schema: type: object properties: error: type: string example: An error occured at Linear components: securitySchemes: apiKeyHeader: type: apiKey description: >- Authenticate your account by including your secret key in API requests. You can manage your API keys in the [Dashboard](https://app.getfernand.com/). Authentication to the API is performed by using the HTTP Header X-API-Key. name: X-API-Key in: header x-last-modified: 1764750344730 ````