> For the complete documentation index, see [llms.txt](https://docs.graphlit.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.graphlit.dev/api-guides/use-cases/feeds/project-management/feed-create-jira.md).

# Create Jira Feed

## User Intent

"How do I sync Jira issues? Show me Jira feed configuration."

## Operation

**SDK Method**: `createFeed()` with FeedTypes.Issue\
**Feed Service**: Jira\
**Auth**: API token

***

## Code Example (TypeScript)

```typescript
import { Graphlit } from 'graphlit-client';
import {
  FeedTypes,
  FeedServiceTypes,
  AtlassianJiraFeedPropertiesInput,
} from 'graphlit-client/dist/generated/graphql-types';

const graphlit = new Graphlit();

const jiraSiteUrl = process.env.JIRA_SITE_URL!; // e.g., https://company.atlassian.net
const jiraProjectKey = process.env.JIRA_PROJECT_KEY!; // e.g., ENG

const feed = await graphlit.createFeed({
  name: 'Engineering Jira',
  type: FeedTypes.Issue,
  issue: {
    type: FeedServiceTypes.AtlassianJira,
    jira: {
      uri: jiraSiteUrl,
      email: process.env.JIRA_EMAIL!,
      token: process.env.JIRA_API_TOKEN!,
      project: jiraProjectKey,
      readLimit: 100,
      includeAttachments: true,
    },
  },
  // Optional: add workflow for content processing
  // workflow: { id: workflow.createWorkflow.id }
});
```

***

## Configuration

**uri**: Jira instance URL\
**project**: Project key\
**email/token**: Atlassian account email and API token\
**readLimit**: Number of issues per sync\
**includeAttachments**: Toggle attachment ingestion

***

## API Token Setup

1. Jira → Account settings → Security → API tokens
2. Create new API token and copy it to `JIRA_API_TOKEN`
3. Set `JIRA_EMAIL` to the Atlassian account email
4. Set `JIRA_SITE_URL` (for example, `https://company.atlassian.net`)
5. Set `JIRA_PROJECT_KEY` to the project you want to sync

> ℹ️ **Finding project keys**: Jira project keys are visible in the project list (`Projects → View all projects`) or via the Jira REST API (`GET /rest/api/3/project/search`). Use the exact key (e.g., `ENG`).

***