# Create GitHub Issues Feed

## User Intent

"How do I sync GitHub issues from a repository? Show me GitHub Issues feed configuration."

## Operation

**SDK Method**: `createFeed()` with FeedTypes.Issue\
**Auth**: GitHub personal access token or OAuth

***

## Code Example (TypeScript)

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

const graphlit = new Graphlit();

// Use the GitHub credential stored in the Developer Portal
const authorizationId = process.env.GRAPHLIT_GITHUB_ISSUES_AUTH_ID!;

const repositoriesInput: GitHubRepositoriesInput = {
  authenticationType: GitHubIssueAuthenticationTypes.OAuth,
  authorizationId,
};

// Enumerate repositories this credential can access
const repositoriesResponse = await graphlit.queryGitHubRepositories(repositoriesInput);
const repositories = repositoriesResponse.githubRepositories?.results ?? [];

if (repositories.length === 0) {
  throw new Error('No GitHub repositories available for the authorized account');
}

const { repositoryOwner, repositoryName } = repositories[0]!;
console.log(`Using GitHub repository: ${repositoryOwner}/${repositoryName}`);

const feed = await graphlit.createFeed({
  name: 'GraphQL Issues',
  type: FeedTypes.Issue,
  issue: {
    type: FeedServiceTypes.GitHubIssues,
    github: {
      authorizationId,
      authenticationType: GitHubIssueAuthenticationTypes.OAuth,
      repositoryOwner: repositoryOwner!,
      repositoryName: repositoryName!,
      readLimit: 100,
      includeAttachments: true,
    },
  },
  // Optional: add workflow for content processing
  // workflow: { id: workflow.createWorkflow.id }
});

console.log(`Created GitHub Issues feed: ${feed.createFeed.id}`);
```

***

## Configuration

**repositoryOwner**: GitHub username or organization\
**repositoryName**: Repository name\
**authorizationId**: Stored GitHub credential identifier (OAuth recommended)\
**authenticationType**: `GitHubIssueAuthenticationTypes.OAuth` or `GitHubIssueAuthenticationTypes.PersonalAccessToken`\
**readLimit**: Number of issues to sync\
**includeAttachments**: Download issue attachments

***

## GitHub Token Setup

1. Developer Portal → Connectors → GitHub Issues
2. Complete OAuth flow with required scopes (`repo`, `write:discussion`, `read:user` as needed)
3. Store the resulting credential; note the `authorizationId`
4. Use `queryGitHubRepositories` to confirm repository access before creating feeds

***

## What Gets Synced

* Issue titles and descriptions
* Issue numbers and states (open/closed)
* Labels and milestones
* Assignees and authors
* Comments and reactions
* Timestamps (created, updated, closed)

***

## Use Cases

**Product Feedback**:

```typescript
repositoryOwner: 'facebook',
repositoryName: 'react'
```

**Bug Tracking**:

```typescript
repositoryOwner: 'your-org',
repositoryName: 'your-product'
```

**Support Tickets**:

```typescript
repositoryOwner: 'company',
repositoryName: 'customer-support'
```

***

## OAuth vs Personal Access Token

**Use OAuth when:**

* Building multi-user applications
* Need user-specific permissions
* Want connector-based auth

**Use Personal Access Token when:**

* Single-user automation
* Service account access
* Simpler setup

***

## Related

* [GitHub Commits Feed](https://docs.graphlit.dev/api-guides/use-cases/feeds/project-management/feed-create-github-commits) - Sync repository commits
* [GitHub Pull Requests Feed](https://docs.graphlit.dev/api-guides/use-cases/feeds/project-management/feed-create-github-pull-requests) - Sync pull requests
* [GitHub Repository Feed](https://docs.graphlit.dev/api-guides/use-cases/feeds/cloud-storage/feed-create-github) - Sync repo files
* [Linear Feed](https://docs.graphlit.dev/api-guides/use-cases/feeds/project-management/feed-create-linear) - Linear issue tracking
* [Jira Feed](https://docs.graphlit.dev/api-guides/use-cases/feeds/project-management/feed-create-jira) - Jira issue tracking