Custom GitHub Webhooks to Email
When your custom GitHub webhook fires (from a GitHub App or Action), Notis routes the event data to an email so you can act on it without writing backend code.
Trigger
Webhook received
Notis starts this workflow when an external tool or custom backend sends an HTTP request.
Action
Send Email
Sends an email via gmail api using the authenticated user's google profile display name, requiring `is html=true` if the body contains html and valid `s3key`, `mimetype`, `name` for any attachment.
Why this helps
Complex GitHub scenarios (custom Actions, third-party Apps, edge cases) don't have native triggers, forcing teams to build custom backends or ignore events entirely.
- Enable automations for GitHub scenarios that don't have native triggers
- Keep custom logic in plain-language prompts instead of backend code
- Route any GitHub webhook to email without infrastructure overhead
- Extend automation to GitHub Apps or third-party integrations
Setup
Build it in a few focused steps.
- 1Connect GitHub and Gmail to Notis
- 2Tell Notis: 'When a webhook is received, parse the GitHub event and send an email with the key details'
- 3Select 'Notis Webhook' as your trigger type, which gives you a unique webhook URL to configure in GitHub
- 4Create or configure your GitHub webhook (App, Action, or custom) to POST to the Notis webhook URL
- 5Test by triggering your custom GitHub event and verify the email arrives with the event details
Questions about this workflow
How do I set up the webhook in GitHub?
In GitHub Settings > Webhooks or in a GitHub App configuration, add the Notis webhook URL that Notis provides, and select which events to send.
What information can I include in the email?
Notis parses the webhook JSON payload, so you can include any data GitHub sends (event type, actor, repository, custom fields, etc.).
Can I filter webhook events before emailing?
Yes, tell Notis to only email on specific event types or conditions within the webhook payload.
When this happens · Trigger
Do this · Action
Supported Triggers and Actions
Notis builds workflows that link GitHub to Gmail. A trigger fires from one place; an action lands in another.
GitHub triggers
Gmail actions
New Workflow Artifact Created
Triggers when a new workflow artifact is created in a GitHub repository. Monitors for newly created GitHub Actions workflow artifacts. Optionally filters by artifact name to restrict monitoring to specific artifacts.
Modify email labels
Adds and/or removes specified gmail labels for a message; ensure `message id` and all `label ids` are valid (use 'listlabels' for custom label ids).
Branch Changed
Triggers when a GitHub branch changes. Monitors a specific branch for: - New commits pushed (head commit SHA changes) - Protection status toggled (branch becomes protected or unprotected) - Protection settings changed, including: required status checks and their enforcement level, admin enforcement, required pull request reviews (dismiss stale reviews, code owner reviews, approving review count, last push approval), required linear history, force push allowance, deletion allowance, conversation resolution, branch locking, and fork syncing.
Create email draft
Creates a gmail email draft, supporting to/cc/bcc, subject, plain/html body (ensure `is html=true` for html), attachments, and threading.
New Branch Created
Triggers when a new branch is created in a GitHub repository. Detects newly created branches. Deleted branches do not fire events.
Create label
Creates a new label with a unique name in the specified user's gmail account.
Check Run Status / Conclusion Changed
Triggers when a specific GitHub check run changes its status or conclusion. Monitors a single check run for changes to: status (queued, in_progress, completed, etc.), conclusion (success, failure, neutral, cancelled, skipped, timed_out, action_required), started_at, and completed_at.
Delete Draft
Permanently deletes a specific gmail draft using its id; ensure the draft exists and the user has necessary permissions for the given `user id`.
Check Suite Status / Conclusion Changed
Triggers when a GitHub check suite changes its status or conclusion for a given ref. Monitors all check suites associated with a git reference (branch, tag, or commit SHA) for changes to status (queued, in_progress, completed, etc.) and conclusion (success, failure, neutral, cancelled, skipped, timed_out, action_required, startup_failure, stale). Optionally filters by GitHub App ID.
Delete message
Permanently deletes a specific email message by its id from a gmail mailbox; for `user id`, use 'me' for the authenticated user or an email address to which the authenticated user has delegated access.
New Code Scanning Alert Created
Triggers when a new code scanning alert is created in a repository. Fires an event for each newly created code scanning alert detected in the configured repository. Alerts can be filtered by Git reference, scanning tool, state, and severity. The payload includes the alert number, rule details, tool information, state, severity, and the location of the most recent instance.
Fetch emails
Fetches a list of email messages from a gmail account, supporting filtering, pagination, and optional full content retrieval.
New Repository Collaborator Added
Triggers when a new collaborator is added to a GitHub repository. Monitors the full list of collaborators on a repository and fires an event for each newly added collaborator. The payload includes the collaborator's GitHub username, account ID, profile URL, avatar URL, permission flags (pull, triage, push, maintain, admin), and assigned role name.
Fetch message by message ID
Fetches a specific email message by its id, provided the `message id` exists and is accessible to the authenticated `user id`.
Commit Event
Triggered when a new commit is pushed to a repository.
Fetch Message by Thread ID
Retrieves messages from a gmail thread using its `thread id`, where the thread must be accessible by the specified `user id`.
Connect any two apps with Notis in the middle.
Not just GitHub and Gmail. Any combination from 1,000+ integrations.
When this happens · Trigger
Do this · Action
Save your first hour today.
7 days free trial with 20$ free usage included.
No card. Works with personal or business Gmail.