Skip to main content
Skip table of contents

Email service provider: SendGrid

Account configuration

This section describes how to set up a SendGrid account to configure an RPI SendGrid email channel.

Setting up an Account

  1. To acquire a SendGrid account, you will need to sign up for either a free or a paid account. If you wish to sign up for a paid account, navigate to To sign up for a free SendGrid account, navigate to

  2. At the SendGrid home page, hover over the Pricing tab and click Start for Free.

  1. A SendGrid sign up form will be displayed. Fill in the required details and click Create Account.

  1. Once you have created your account successfully, you will be emailed by SendGrid support to activate your account, and may log into the SendGrid portal.

The table below describes the SendGrid RESTful service-based API calls utilized by the RPI SendGrid channel plugin.






api_user=your_sendgrid_ username&api_key=your_ sendgrid_password&to=d &toname=Destination&su bject=Example_Subject&t ext=testingtextbody&from

This endpoint allows you to send email.


api_user=your_sendgrid_ username&api_key=your_ sendgrid_password

View your SendGrid



api_user=your_sendgrid_ username&api_key=your_ sendgrid_password&email =emailToDelete@domain.


Delete entries in the Unsubscribes list. son


api_user=your_sendgrid_ username&api_key=your_ sendgrid_password&date


Retrieve entries in the Unsubscribes list.

For more details about SendGrid APIs, please see

Setting up an API key for SendGrid Web API v3

An API key and API key ID are required to configure a SendGrid email channel to use the SendGrid Web API v3.

  1. In a browser, navigate to and sign in.

  2. Click Settings > API Keys.

  3. In the API Keys section, click Create API Key and select General API Key.

  1. Enter the name of the API Key, select API Key Permission and click Save.

  1. Copy the API Key and store it in a safe place to avoid your account being compromised.

Note that a SendGrid account must have the following minimum required permissions when used with RPI:

  • API Keys - Read Access

  • Mail Send - Full Access

  • Category - Full Access

  • Email Activity - Read Access

  • Suppressions - Full Access

  • Tracking - Full Access

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.