ReleasePad
Back to Knowledge Base GitHub Integration

How to Connect Your GitHub Repository

ReleasePad can turn your GitHub commits into draft release notes automatically. Connect a repo, set up a webhook, and every push to your monitored branch generates polished drafts you can review and publish.

Step 1: Add your repository

Go to Settings → GitHub Integration in your ReleasePad dashboard and click Add Repository. A drawer slides in with three fields:

  • Repository Owner — your GitHub username or organization (e.g., acme-corp)
  • Repository Name — just the repo name, not the full URL (e.g., web-app)
  • Branch to Monitor — the branch to track, defaults to main

Click Connect Repository to save. Your repo appears in the table with a yellow “Pending Setup” badge — the webhook still needs to be configured on GitHub’s side.

You can connect up to 3 repositories per product.

Step 2: Set up the webhook on GitHub

After connecting, click the info icon next to your repo to see the setup instructions. You’ll need two values shown on screen: a Payload URL and a Secret.

  1. Open your repository on GitHub and go to Settings → Webhooks
  2. Click Add webhook
  3. Paste the Payload URL from ReleasePad
  4. Set Content type to application/json
  5. Paste the Secret from ReleasePad
  6. Under events, select Just the push event
  7. Click Add webhook

GitHub sends a ping right away. Once ReleasePad receives it, the status changes to green “Active” and you’ll get a confirmation email.

Step 3: Push code and get drafts

From here, everything is automatic:

  1. You push commits to the monitored branch
  2. ReleasePad captures them via the webhook
  3. AI analyzes the commits and creates draft posts
  4. You get an email when drafts are ready to review

Drafts are never auto-published — you always review and publish them yourself from the posts list.

Skipping commits

If a commit shouldn’t be turned into a release note (CI config, typo fixes, etc.), include [skip] anywhere in the commit message:

git commit -m "Update CI pipeline [skip]"

ReleasePad will save the commit but won’t include it in the AI generation.

AI settings

You can control how the AI writes your drafts under Settings → AI:

  • Tone — Professional, Casual, or Technical
  • Language — English, Spanish, French, German, Portuguese, or Italian
  • Detail Level — Brief, Detailed, or Comprehensive
  • Emoji Style — None, Subtle, or Expressive

These settings apply to all future drafts.

Disconnecting a repo

Click the trash icon next to any connected repo. A confirmation modal appears — once you confirm, all commits and webhook data for that repo are removed. You’ll need to delete the webhook from GitHub separately.

Need more help?

Can't find what you're looking for? Our team is happy to help you get set up.

Contact support
Try me now!