---
title: "Example: Using SendGrid as custom email provider for notifications"
description: Follow these steps to have PingOne use SendGrid for sending notifications to users:
component: pingone
page_id: pingone:settings:p1_using_sendgrid_as_custom_email_provider
canonical_url: https://docs.pingidentity.com/pingone/settings/p1_using_sendgrid_as_custom_email_provider.html
---

# Example: Using SendGrid as custom email provider for notifications

Follow these steps to have PingOne use SendGrid for sending notifications to users:

1. Go to **Settings > Senders**.

2. Click **+**, enter the following options, and then click **Next**:

   1. In the **Sender Type** list, select **Email**.

   2. In the **Provider Type** list, select **Custom Provider**

3. For **Provider Name**, enter a name to identify your SendGrid configuration.

4. For **Authorization**, select **Bearer** and enter the token to use for your SendGrid account.

5. Enter the **From Address** to use in the notifications. This address must be a verified sender in SendGrid.

6. (Optional) Enter the **From Name** value you want to use in the notifications.

7. (Optional) Enter the **Reply-To Name** and **Reply-To Address** values you want to use in the notifications.

8. Provide the information required by the SendGrid API:

   1. In the **Type** list, select **POST**.

   2. In the **URL** field, enter `https://api.sendgrid.com/v3/mail/send`.

   3. For the body of the request, select **Raw**.

   4. In the **Raw** field, enter the following JSON:

      `{"personalizations":[{"to":[{"email":"${to}"}]}],"from":{"email":"${from}","name":"${from.name}"},"reply_to":{"email":"${reply-to}","name":"${reply-to.name}"},"subject":"${subject}","content":[{"type":"text/plain","value":"${message}"}]}`

      |   |                                                                                                                                                                                                                                                             |
      | - | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
      |   | Some of the variables in this sample JSON are optional, for example, `${from.name}`. The variables required by PingOne are listed in the UI and in [Using a custom email provider for notifications](p1_using_custom_email_provider_for_notifications.html) |

   5. Verify that the single header required by SendGrid is already shown `(content-type:application/json)`. If not, click **Add Header** and enter the header type and value.

   6. After entering all of the information, click **Send Test Email** to send an email to verify that everything is working correctly. Enter the email address to send the test email to and click **Send**.

      |   |                                                                                                                                                                                                       |
      | - | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
      |   | If you're editing existing settings, the token is not displayed when the page is loaded. To send a test email, you must enter the token alongside the email address you specified for the test email. |

9. Click **Save**.

   |   |                                                                                                                                                |
   | - | ---------------------------------------------------------------------------------------------------------------------------------------------- |
   |   | **Save** is disabled until you have filled in all the required fields and have included all the required variables in the body of the request. |

10. If you have more than one sender defined, select the three dots next to the Sender new entry and select **Make Active**.

    |   |                                                                                             |
    | - | ------------------------------------------------------------------------------------------- |
    |   | You can define multiple senders, but you can only have one active sender at any given time. |