Skip to main content

About email notifications for pushes to your repository

You can choose to automatically send email notifications to a specific email address when anyone pushes to the repository.

Who can use this feature?

People with admin permissions in a repository can enable email notifications for pushes to your repository.

Each email notification for a push to a repository lists the new commits and links to a diff containing just those commits. In the email notification you'll see:

  • The name of the repository where the commit was made
  • The branch a commit was made in
  • The SHA1 of the commit, including a link to the diff in GitHub Enterprise Cloud
  • The author of the commit
  • The date when the commit was made
  • The files that were changed as part of the commit
  • The commit message

You can filter email notifications you receive for pushes to a repository. For more information, see "Configuring notifications."

Note

Notifications for pushes to your repository will bypass restrictions for email notifications to verified domains configured in your enterprise account or organisation.

Enabling email notifications for pushes to your repository

  1. On GitHub, navigate to the main page of the repository.

  2. Under your repository name, click Settings. If you cannot see the "Settings" tab, select the dropdown menu, then click Settings.

    Screenshot of a repository header showing the tabs. The "Settings" tab is highlighted by a dark orange outline.

  3. In the "Integrations" section of the sidebar, click Email notifications.

  4. In the "Address" field, type up to two email addresses, separated by whitespace, where you'd like notifications to be sent. If you'd like to send emails to more than two accounts, set one of the email addresses to a group email address.

  5. If you operate your own server, you can verify the integrity of emails via the "Approved header." The "Approved header" is a token or secret that you type in this field, and that is sent with the email. If the Approved header of an email matches the token, you can trust that the email is from GitHub Enterprise Cloud.

  6. Click Setup notifications.

Further reading