Skip to content
GitStart's Documentation

Ticketing System Integration Guide

This guide explains how to connect your existing ticketing system with GitStart and manage the flow of work between your team and GitStart developers.

Supported Ticketing Systems

GitStart integrates with popular issue tracking and project management tools:

  • Jira
  • Linear
  • GitHub Issues
  • Azure DevOps (contact us for details)

Connecting Your Ticketing System

Dashboard Integration

From the GitStart dashboard, navigate to the “Ticketing System” integration tab:

  1. Select Your Ticketing System

    • Choose from Jira, Linear, or GitHub Issues
    • Click “Connect” to begin the integration process

  2. Authorize the Connection

    • An admin user must approve the GitStart integration
    • Follow the authorization prompts for your selected platform

  3. Configure Workspace Access

    • Select the specific workspace(s) to connect:
      • Jira: Select project(s)
      • Linear: Select team(s)
      • GitHub: Select repository(ies)

  4. Set Up Ticket Import Rules

    • Configure filters to determine which tickets are imported to GitStart
    • Standard filter: label = gitstart (add the “gitstart” label to assign tickets)
    • You can create custom filters based on status, assignee, labels, or other criteria

Advanced Integration with PAT Tokens

For more granular permission control, you can integrate using Personal Access Tokens (PAT):

Jira PAT Integration

  1. Generate a Jira PAT with appropriate permissions in your Jira admin settings
  2. In the GitStart dashboard, select “Connect via PAT”
  3. Enter your Jira instance URL and the PAT
  4. Configure webhook settings (we provide documentation for manual webhook setup)

Linear and GitHub PAT Integration

Similar processes apply for Linear and GitHub, with system-specific token generation steps. Contact our support team for detailed instructions.

Managing Tickets with GitStart

Assigning Work to GitStart

There are two ways to assign work to GitStart:

  1. Create Tickets Directly in GitStart

    • Use the AI Chat Interface in GitStart Ticket Studio to generate structured tickets
    • Provide requirements, user stories, or specifications
    • The AI will help structure the information into a well-formatted ticket
    • Click the “Hand Off” button to officially assign the ticket to GitStart

  2. Import Existing Tickets

    • Tickets matching your import rules will appear in the Triage Tab
    • Review imported tickets and enhance descriptions if needed
    • Changes to ticket descriptions sync back to your original ticketing system
    • Click the “Hand Off” button to assign the ticket to GitStart

Best Practices for Ticket Creation

For optimal results, ensure your tickets include:

  • Clear Title: Briefly describe the task
  • Detailed Description: Goals, specifications, user stories, or steps to reproduce
  • Acceptance Criteria: Define what constitutes successful completion
  • Attachments: Include relevant screenshots, designs, or resources

Updating Tickets

  • Synced Tickets: Changes made to ticket descriptions in your original ticketing system will automatically sync to GitStart (may take a few hours to propagate)
  • GitStart-Created Tickets: Currently, editing handed-off tickets created directly in GitStart is not supported

Ticket Prioritization

When assigning tickets, you can set priority levels:

  • Urgent: Overrides all tasks, may disrupt sprint delivery
  • High: Must be completed this sprint
  • Medium: Work on after high priorities are done
  • Low: Only pick up if all other tasks are complete

Tracking Progress

Ticket Status Tracking

  • Ticket status updates in GitStart sync back to your original ticketing system
  • You can view current status, assigned developers, and progress in both systems
  • PR links will be added to tickets when code is ready for review

Notification Settings

Configure notification preferences in the GitStart dashboard:

  • Receive alerts for ticket status changes
  • Get notified when PRs are ready for review
  • Customize notification delivery (email, Slack, etc.)

Need Help?

For assistance with ticketing system integration, contact our support team at support@gitstart.com or refer to our video instructions.