Onboard with NHS Notify - You must follow the steps to prepare for integration

1. Prepare your integration

You must prepare your integration before you can get access to NHS Notify’s integration environment.

You’ll need technical or developer support to complete tasks in this step.

If you’re using NHS Notify API

You’ll need to:

Set up your APIM application ID

To set up an APIM application ID, you need to:

  1. Sign in to your NHS Digital developer account (opens in a new tab).
  2. Create an APIM application.
  3. Select ‘integration test’ as the environment.
  4. Select ‘Communications Manager (integration environment)’ as the connected API.
Choose how you want to see your message performance

To see how your messages perform, you can get the status of a message (opens in a new tab) or choose to receive realtime message callbacks (opens in a new tab).

If you want to receive realtime message status callbacks, you’ll need to:

If you’re using NHS Notify MESH

You’ll need to:

  1. Set up your MESH mailboxes (opens in a new tab) and make a note of their IDs.
  2. Decide which reports you want when you get reports on how your messages perform.

2. Confirm your setup to get access to our integration environment

You must confirm how you’ll be set up with NHS Notify using our online form so we can prepare your integration environment to meet your needs.

Information:

Only complete the online form and confirm your setup if you’ve been invited to onboard.

Confirm your setup with NHS Notify

Before you confirm your setup

In the form you’ll be asked to:

Confirm your use case

You can only use NHS Notify if your organisation or service sends messages that are:

Provide your message sender names

When you send messages you’ll need to tell your recipients who your messages are from by creating message sender names.

Before you provide your message sender names, you should understand more about:

Provide more detail about your messages and how they’ll be sent

You’ll be asked if your organisation or service will:

  • have finished drafts of the messages you want to send
  • send NHS App messages and if so, which links and URLs you’ll include
  • send letters in other languages and if so, which languages
  • send letters in accessible formats and if so, which formats
  • use Personal Demographics Service (PDS) fields
  • have your PDS test data ready
  • use custom personalisation fields
  • have test data prepared for your custom personalisation fields

The form will also ask for the routing plans that you want to use for your messages.

Tell us who will create and submit templates

You do not need to do this if you send direct messages and use free-text inputs.

When you get access to NHS Notify’s integration environment, you’ll need to create and submit your templates. These templates will be used as the messages you send when you go live.

To access this feature, you must nominate someone in your organisation or service to sign in with NHS Notify. This is because creating and submitting templates is only available to one person in an organisation or service at this time.

To sign into NHS Notify you must have a Care Identity (CIS2 authentication). If you do not have a Care Identity, we can help you create one.

Give accurate estimates on your message volumes and frequency

We need to understand how many messages you need to send and how often to set up your integration environment.

You’ll need to provide:

  • how many messages you want to send per day
  • the maximum amount of messages you might send per day

After you submit the form, it will be reviewed by NHS Notify’s onboarding team.

They’ll contact you to either:

  • ask you about some of the answers you provided
  • provide access to NHS Notify’s integration environment

3. Build your integration

Once you get access to our integration environment, you can start building your integration with NHS Notify API (opens in a new tab) or NHS Notify MESH (opens in a new tab).

How you build your integration to meet your needs is your responsibility.

If you’re sending campaign or event based messages, you need to create and submit your templates during this step. You will also need to approve your messages before we send them.

4. Complete integration testing

You’ll need to complete integration testing to make sure you’re ready to start sending messages with NHS Notify.

If you’re sending NHS App messages, you’ll also need to complete NHS App testing.

If you’re using NHS Notify API

Your onboarding manager will ask for your:

  • production (PROD) application name
  • PROD application ID
  • consumer organisation name
  • JWKS resource URL (if you’re self-hosting)
  • key ID for JWKS and public key (if NHS Notify is hosting your keys via APIM)

If you’re using NHS Notify MESH

Your onboarding manager will ask for your PROD Mesh Mailbox ID.