> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dacard.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a Linear issue

> Create a Linear issue without going through the dac-backlog approval flow. Direct path for ad-hoc issues.

Create a Linear issue without going through the dac-backlog approval flow. Direct path for ad-hoc issues created from in-app surfaces (e.g., from a tribal note, from the rail's quick-action menu).

```bash theme={null}
curl -X POST https://app.dacard.ai/api/linear/create-issue \
  -H "Authorization: Bearer $DACARD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "teamId": "lin_team_xyz",
    "title": "Audit the onboarding email cadence",
    "description": "Day 7 email is opening 38% but click-through is 4%. Worth a copy pass.",
    "labelIds": ["lbl_dac_coaching"]
  }'
```

| Property | Value |
| - | - |
| **Auth** | Required |
| **Required integration** | Linear |
| **Idempotent** | No |

## Body

| Field | Type | Required | Notes |
| - | - | - | - |
| `teamId` | string | yes | Linear team id. |
| `title` | string | yes | Issue title. |
| `description` | string | no | Markdown body. |
| `labelIds` | string\[] | no | Linear label ids. |
| `assigneeId` | string | no | Linear user id. |
| `priority` | integer | no | 0-4 per Linear's scale. |

## Errors

| Status | Code | When |
| - | - | - |
| 401 | `AUTH_REQUIRED` | No session. |
| 401 | `INTEGRATION_DISCONNECT` | Linear OAuth expired. |
| 500 | `INTERNAL_ERROR` | Linear API call failed. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.