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

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.graphlit.dev/api-guides/use-cases/feeds/project-management/feed-create-jira.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.