Personalisation
You can send personalised messages using a single template.
To personalise a message, use double brackets to add a placeholder to your content. For example:
Hello ((firstName)), your NHS Number is ((nhsNumber))
Personal Demographics Service (PDS) personalisation fields
NHS Notify uses the Personal Demographics Service (PDS) to find and populate certain personalisation fields for each recipient. This happens automatically when you tell us who you want to message using recipients’ NHS numbers.
You can use the following PDS personalisation fields in your templates:
- fullName
- firstName
- middleNames
- lastName
- namePrefix
- nameSuffix
- nhsNumber
- date
Any placeholders in your content need to match the PDS personalisation fields.
Providing your own personalisation data
You can provide your own personalisation data.
Do not send us personalisation data that’s already available in PDS. We’ll use the PDS data over your own data in this case.
If you’re using NHS Notify API
Include a personalisation block in your API request.
For example, if you wanted to include ‘practice’ as a personalisation field, the personalisation block would be:
“practice”: “PRACTICE_NAME”,
Read the API documentation to find out where to put this in your request.
If you’re using NHS Notify MESH
Include the personalisation fields as columns in your CSV file.
The column names should start with ‘personalisation_’, followed by the same wording as the placeholders in your template.
For example, if you wanted to include ‘practice’ as a personalisation field, the column name would be:
nhsNumber,requestItemRefId,personalisation_practice