GitHub Integration

Automatically create GitHub issues from your form submissions, perfect for bug reports, feature requests, and user feedback.

Features

• Create issues in any repository
• Auto-populate issue templates
• Assign labels and assignees
• Link back to original form submission

Prerequisites

• GitHub account with repository access
• Personal Access Token with repo scope

Setup

1. Create Personal Access Token

1. Go to GitHub Settings 
2. Click “Generate new token (classic)”
3. Select scopes:
   • repo (Full control of private repositories)
   • public_repo (Access public repositories)
4. Copy the token (save it securely)

2. Configure Repository

Ensure your repository has:

• Issue tracking enabled
• Appropriate issue templates (optional)

3. Set Up Integration

1. In your dashboard, go to Integrations
2. Click “Add Integration”
3. Select “GitHub”
4. Enter your GitHub username
5. Paste your Personal Access Token
6. Select target repository
7. Configure issue template
8. Click “Test Integration”
9. Click “Save”

Issue Templates

Bug Report Template

## Bug Report
 
**Submitted by:** {{name}} ({{email}})
 
**Description:**
{{description}}
 
**Steps to reproduce:**
{{steps}}
 
**Expected behavior:**
{{expected}}
 
**Browser/Device:**
{{browser}}
 
**Additional context:**
{{context}}
 
---
*This issue was automatically created from a form submission.*
[View original submission]({{dashboard_url}})

Feature Request Template

## Feature Request
 
**Submitted by:** {{name}} ({{email}})
 
**Problem:**
{{problem}}
 
**Proposed Solution:**
{{solution}}
 
**Alternatives considered:**
{{alternatives}}
 
**Use case:**
{{use_case}}
 
---
*This issue was automatically created from a form submission.*
[View original submission]({{dashboard_url}})

Configuration Options

Labels

Automatically assign labels to created issues:

• bug
• enhancement
• question
• Custom labels

Assignees

Auto-assign issues to specific team members or use round-robin assignment.

Issue Title Format

Customize how issue titles are generated:

• Bug: {{title}}
• Feature: {{title}}
• {{name}}: {{subject}}

Advanced Features

Conditional Issue Creation

Only create issues based on form responses:

• Priority level
• Issue type
• User consent

Custom Fields Mapping

Map form fields to GitHub issue fields:

• Title → Issue title
• Description → Issue body
• Priority → Labels
• Category → Labels

Security Considerations

• Store tokens securely (never in code)
• Use fine-grained permissions when possible
• Regularly rotate tokens
• Monitor created issues for sensitive data

Troubleshooting

Authentication Failed

• Verify token has correct scopes
• Check token hasn’t expired
• Ensure user has repository access

Repository Not Found

• Confirm repository exists and is accessible
• Check spelling of repository name
• Verify organization/user permissions

Issues Not Creating

• Test integration with “Test” button
• Check form field mappings
• Review GitHub API rate limits

Rate Limits

GitHub API has rate limits:

• 5000 requests per hour for authenticated requests
• Monitor usage in your dashboard

Best Practices

1. Use Descriptive Titles: Help developers understand issues quickly
2. Include Context: Link back to original submissions
3. Categorize Properly: Use labels for better organization
4. Test Thoroughly: Use test forms before going live
5. Monitor Activity: Review created issues regularly

Need Help?

For GitHub integration issues, check our API documentation or contact support.