Integrations Overview

GitScrum Studio connects with the tools you already use. From version control to communication platforms, integrations extend your workflow beyond project management.

Available Integrations

Version Control

Communication

Calendar

Development

Setting Up Integrations

Workspace Level

Some integrations apply workspace-wide:

1. Go to Workspace Settings
2. Select Integrations
3. Choose the integration
4. Follow authorization flow
5. Configure settings

Project Level

Others are project-specific:

1. Open Project Settings
2. Select Integrations tab
3. Enable desired integrations
4. Configure per integration

GitHub Integration

Connecting

1. Go to Workspace Settings > Integrations
2. Click "Connect GitHub"
3. Authorize GitScrum
4. Select repositories

Features

Pull Request Linking

• Reference task #123 in PR title/description
• Task shows linked PR with status
• PR merge can auto-transition task

Commit References

• Include task number in commit message
• Commits appear in task activity

Branch Creation

• Create branch from task
• Naming convention: feature/123-task-title

Sync Options

• Two-way sync with GitHub Issues (optional)
• Auto-create tasks from issues
• Status synchronization

Configuration

Slack Integration

Connecting

1. Go to Workspace Settings > Integrations
2. Click "Add to Slack"
3. Choose workspace
4. Select default channel

Features

Notifications

• Task created/updated
• Comments added
• Assignments changed
• Due dates approaching

Commands

• /gitscrum create - Create task from Slack
• /gitscrum search - Find tasks
• /gitscrum timer - Start time tracking

Interactive Messages

• Update task status from Slack
• Add comments without leaving Slack
• Assign team members

Per-Channel Configuration

Route notifications by type:

• #dev-tasks → Development project notifications
• #bugs → Bug type notifications
• #urgent → High priority notifications

Webhook Integration

Use Cases

• Custom notifications to your systems
• Integration with internal tools
• Audit logging
• Trigger external workflows

Setting Up Webhooks

1. Go to Project Settings > Webhooks
2. Click "Add Webhook"
3. Enter:

• Endpoint URL (HTTPS required)
• Secret key (for signature verification)
• Events to trigger

1. Save

Events Available

Payload Format

{
  "event": "task.updated",
  "timestamp": "2026-01-15T10:30:00Z",
  "workspace_id": "ws_123",
  "project_id": "proj_456",
  "data": {
    "task_id": "task_789",
    "changes": {
      "status": {
        "from": "In Progress",
        "to": "Done"
      }
    }
  }
}

Security

Webhooks include a signature header:

• X-GitScrum-Signature: HMAC-SHA256 of payload
• Verify using your secret key
• Reject requests with invalid signatures

API Access

API Keys

1. Go to Workspace Settings > API
2. Click "Generate API Key"
3. Name the key (for identification)
4. Copy the key (shown once only)

Rate Limits

Documentation

Full API documentation available at:

• API Reference
• Interactive playground in settings
• OpenAPI/Swagger spec download

Calendar Sync

Google Calendar

1. Connect Google account
2. Select calendar for sync
3. Configure sync settings:

• Task due dates as events
• Sprint dates as events
• Milestone dates

Outlook Calendar

1. Connect Microsoft account
2. Select calendar
3. Configure event creation

Sync Direction

Integration Permissions

Who Can Configure

OAuth Scopes

When connecting third-party services, GitScrum requests minimal permissions:

• GitHub: Read repos, manage hooks
• Slack: Send messages, read channels
• Google: Calendar read/write

Review permissions during authorization.

Troubleshooting

Integration Not Working

1. Check connection status in settings
2. Verify OAuth hasn't expired
3. Re-authorize if needed
4. Check webhook delivery logs

Webhook Failures

View delivery history:

1. Go to Project Settings > Webhooks
2. Click the webhook
3. See recent deliveries
4. Check response codes

Rate Limiting

If hitting limits:

• Batch operations where possible
• Cache responses locally
• Contact support for limit increases

Coming Soon

Planned integrations:

• Jira import/sync
• Trello import
• Figma comments sync
• Linear import
• Notion pages sync

Request integrations through support.

How to Report a Problem or Request a Feature

If an integration isn't working or you need a new integration, submit feedback through GitScrum Studio. In the Sidebar, click on Support Tickets and open a ticket.