Skip to main content
All CollectionsNPS
NPS Implementation - sending NPS Invitations via SendGrid campaigns
NPS Implementation - sending NPS Invitations via SendGrid campaigns
Costin Floricel avatar
Written by Costin Floricel
Updated over a year ago

You can choose to seamlessly automate the sending of NPS invitations by using our integration with SendGrid.

Of course, you need to send the real (non-anonymized) email addresses of your customers to Reveal.

If you have opted to anonymize this information, you will need to send the NPS invitation emails through your own system, after fetching the NPS invitations from the Reveal API.

Detailed information on this here.

In order to send NPS invitations from Reveal using SendGrid, you need to follow a couple of simple steps:

Select SendGrid as NPS delivery service

Step 1:
Log into your Reveal account and go to Store Settings > General > NPS section > NPS > Click on the pencil to edit:

In the "Sending Provider" field section choose SendGrid

Step 2:
As you can notice, some fields are already pre-filled with some default values, while other fields require your input.

Next to each field, there is an info icon that will display a short description for each field. Please make sure you have filled in all the required fields (marked with *).

Even though the Sending Contact Email is not a required field, we recommend you to fill it in with the email address of the person in charge of NPS invitations campaigns, so they will be able to check if any errors occur while sending NPS invitation emails to your customers, and also be able to check the actual email content daily(also you will be able to send a test email at this email address to see how the NPS will actually look like).

Step 3:
Set the time when to send the email invitations to your customers in the Scheduled Sending Time field.

This is related to the timezone you have set in Store Settings > General > General Settings> Timezone Offset:

Step 5:
Save your settings.

In order to proceed, you will need some information from your SendGrid account.

Connect Reveal and SendGrid

Step 6:

In your SendGrid account generate an API Key.

  • API Key: you can generate an API Key by accessing the SendGrid interface > Settings > API Keys > Create API Key. Please create an API Key with Full Access permissions and make sure you copy your API Key value since afterward you will not be able to access its value.

  • Sender ID: you need the Sender ID value set up in SendGrid interface > Marketing > Senders > Edit Sender > Copy the ID from the URL address bar. We recommend you to set up a separate sender for NPS invitations sent through Reveal.

Step 7:

In your Reveal account go to Store Settings > Integration > SendGrid Settings > Click on the pencil to edit:

Input the API Key and Sender ID from Step 6 > Click Save

Step 8:
In Reveal, go to Store Settings > General > NPS section > NPS SendGrid Email Settings > Pencil button to Configure:

Step 9:
Except for the Unsubscribe Group field, all the other fields are optional.

Below is a short description of each one of the fields:

  • Unsubscribe Group: you can create a separate unsubscribe group from the SendGrid interface > Marketing > Unsubscribe Groups > Create New Group. After saving the group, you will be able to see the group ID on the lower left corner of the card.

  • Design ID: if this field is left blank, it will be automatically generated. If you wish to use a specific design, use the design ID from the SendGrid interface > Design Library. If you choose to use your own design, please make sure you use the custom fields Reveal creates automatically and needs them in the email. You can find these fields in the SendGrid interface > Marketing > Custom Fields > Custom Fields section.

  • NPS Global List ID: this field is optional, if left blank, an id will be automatically generated. The list will contain all contacts who receive an NPS email.

  • Template ID: this field should be filled in for advanced use cases only. This represents the template used in Single Sends.

  • Template Version ID: this field should be filled in for advanced use cases only. This represents the version of the template, which actually contains the HTML code.

Step 10:
Save your settings by clicking on the “Save” button.

Step 11:
In order to make sure everything is set up correctly and there is no missing information, test your configuration, by clicking the “Send a Test Email through SendGrid” button. You will receive the actual NPS email (test invitation email) or an email with the error.

Customize your NPS email design & content

Please keep in mind that you still need to customize the texts and logo for the NPS email, by editing the template generated in your SendGrid account.

First, you need to check the ID generated for your design (in case you left the Design ID field blank, a design has been auto-generated for you). In order to retrieve the ID go to your Reveal account > Settings > NPS section > NPS SendGrid Email Settings > Pencil button to Configure. Note the ID from the Design ID field and go to your SendGrid account > Design Library and choose to edit the one with the same ID.

In case significant changes are brought to the original template, please be careful to thoroughly test the email cross-email-client, since it might look different in various email clients than in the preview provided by SendGrid.

Enable the Post-delivery NPS

After you have completed all the NPS related settings, and the template is also complete, you must enable the module (from Store Settings > General > NPS Settings) by choosing “Enable” for NPS Sending Enabled.


If you wish to send the NPS Invitations manually or if you want to temporarily pause the automated sending, choose the value “Disabled”.



Did this answer your question?