Documentation

Complete guide to setting up and using GitNotifier. Get clean PR notifications in your Slack DM in minutes.

Quick Start

Get GitNotifier running in 3 simple steps

1

Install the GitHub App

Authorize GitNotifier to access your repositories

2

Connect Slack

Add GitNotifier to your Slack workspace

3

Test & Enjoy

Create a test PR and see notifications flow

Core Features

Understand how GitNotifier works under the hood

Webhook Integration

GitNotifier automatically configures GitHub webhooks to receive real-time PR events.

Pull request lifecycle events
Review and comment events
Status check updates

Smart User Mapping

Automatic mapping between GitHub and Slack users with fallback options.

Email-based matching
Username correlation
Manual override options

Actionable Notifications

GitNotifier sends high-signal Slack notifications so teams can react quickly to review activity and delivery issues.

PR reviews, comments, and failed CI alerts
Alert when a merge breaks main
Fast reactions from Slack (reply, emoji triage)

Security First

Enterprise-grade security with minimal data retention and OAuth 2.0.

OAuth 2.0 authentication
Encrypted webhooks
Zero-trust security

Configuration

Customize GitNotifier to match your team's workflow

Repository Settings

Event Filtering

Choose which PR events trigger notifications

User Exclusions

Exclude specific users or bots from notifications

Label Rules

Create rules based on PR labels and status

Advanced Features

Team Management

Manage team permissions and notification preferences

Webhook Customization

Customize webhook endpoints and payloads

Analytics Dashboard

Track notification delivery and team engagement

Testing & Troubleshooting

Verify your setup and resolve common issues

Testing Your Setup

  1. 1Create a test pull request in your connected repository
  2. 2Add a comment or request a review
  3. 3Check your Slack DM for notifications
  4. 4Merge or close the PR to see status updates

Common Issues

No notifications received?

Check webhook configuration and user mapping

Wrong users notified?

Verify GitHub-Slack user mapping in settings

Duplicate messages?

Ensure only one webhook is active per repository

💡 Pro Tip: Use Slack's workflow builder to create test webhook events for development and testing

Need Help?

Get support and explore additional resources

Contact us!

Get help from our technical team

GitHub Issues

Report bugs and request features

API Reference

Explore our REST API endpoints