> ## 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. |