Skip to main content
Table of contents


Receive emails from Email Alert API in integration and staging

In integration and staging Email Alert API defaults to sending emails to a single test address: This is used to simulate a successful email sending.

However, you can override this for specific email addresses for testing purposes. To do this, you will need to be added as a team member to the GOV.UK Email Integration or Staging service in Notify and make changes to govuk-puppet.

In Notify:

  1. Log in using the 2nd-line-support account which is stored in govuk-secrets under govuk-notify/2nd-line-support. You should then receive an email via 2nd Line Support containing a link to sign in to Notify.
  2. Choose the service (GOV.UK Email) in the appropriate environment and navigate to “Team members”. The members with the permission Manage settings, team and usage will be able to add you to this team.

In govuk-puppet:

  1. Add your email address to the common.yml for hieradata and hieradata_aws (these lists need to be kept in sync with the team members list in Notify)
  2. Add your email address to the override whitelist in the YAML file for the environment you’re testing on. This is set as an environment variable via hieradata under the key of govuk::apps::email_alert_api::email_address_override_whitelist. It should look something like this:
  1. Create a branch with these changes and push them to GitHub. Deploy these changes by running integration-puppet-deploy, providing your branch name instead of a release tag.

Once these changes have been deployed and the environment variable EMAIL_ADDRESS_OVERRIDE_WHITELIST is populated with your address you can test that you can receive emails by running the deliver:to_test_email[] rake task.

Testing digest emails

It is possible to re-send an entire digest run (e.g. to test changes that have been made to the email template) in integration. You will need to have added yourself to the whitelist and have a digest subscription (daily or weekly) to something that had a significant update during the time period the digest covers (e.g. daily would be 07:00 the previous day to 07:00 today).

Using a Rails console for email-alert-api, retrieve the digest run that you wish to resend, then delete it, e.g.

digest = DigestRun.where(range: 'daily').last

Then rerun the relevant digest initiator worker (either daily or weekly):

This page was last reviewed on 28 February 2020. It needs to be reviewed again on 28 August 2020 by the page owner #govuk-developers .
This page was set to be reviewed before 28 August 2020 by the page owner #govuk-developers. This might mean the content is out of date.