---
title: "Schedule Emails with SendGrid"
slug: "msg-ss-schedule-emails-sendgrid"
updated: 2024-06-05T13:57:04Z
published: 2024-06-05T13:57:04Z
canonical: "docs.blackthorn.io/msg-ss-schedule-emails-sendgrid"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blackthorn.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Schedule Emails with SendGrid

Use SendGrid from the Events app to send scheduled emails that are created using the Smart Scheduler.

For information about setting up SendGrid, please click [here](https://docs.blackthorn.io/docs/enhanced-emails).

## Pre-requisites

If you haven’t already set up Smart Scheduler, please complete the tasks on the following pages.

1. [Upgrade the Messaging App](https://docs.blackthorn.io/docs/msg-ss-upgrade-messaging-app)
2. [Upgrade the Blackthorn Base, Payments, and Events Apps](https://docs.blackthorn.io/docs/msg-ss-upgrade-base-payments-events-apps)
3. [Assign New Permission Sets](https://docs.blackthorn.io/docs/msg-ss-assign-new-permission-sets)
4. [Create an Org-wide Email Address](https://docs.blackthorn.io/docs/msg-ss-create-org-wide-email-address)
5. [Activate the Smart Scheduler's Feature Toggle](/v1/docs/msg-ss-activate-smart-scheduler-component)
6. [Start Here](https://docs.blackthorn.io/docs/msg-ss-configure-messaging-scheduler-component)
7. [Register Your Account](https://docs.blackthorn.io/docs/msg-ss-register-your-account)
8. [Authenticate a User](https://docs.blackthorn.io/docs/msg-ss-authenticate-user)
9. [Add the BT Event Scheduler Component to the Event Record](https://docs.blackthorn.io/docs/msg-ss-add-event-scheduler-component-event-record)

## Add the SendGrid API Key in the BT Base App

1. Open the Events (Admin) app.
2. Click the Smart Scheduler Admin tab. (If you don’t see the tab, click [here](https://docs.blackthorn.io/docs/ev-ss-configure-event-scheduler-component) to review the steps.)
3. Click **Add API Key**.
4. Enter the **SendGrid API Key**.
5. Click **Save**.  

![SendGrid API Key](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/SendGrid%20API%20Key.png)

Once the **SendGrid API Key** is available in the Events app, you can retrieve it from the Smart Scheduler Admin tab by clicking **Retrieve From Event App** and use it in the BT Base app.

![Retrieve From Events App](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Retrieve%20From%20Events%20App.png)

## Settings

### Turn On/Off the SendGrid Feature

You can turn on/off the feature that allows users to schedule SendGrid emails from the BT Base app.

1. Open to the Events (Admin) app.
2. Click the Smart Scheduler Admin tab.
3. Click the Configuration Settings tab.
4. Toggle the **Allow Schedule creation with SendGrid** setting on or off.
5. Click **Update Setting**.  

![Schedule Settings](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Schedule%20Settings.png)

### Set Email Notifications

You can select SendGrid for email notifications from the Email Notification Settings on the Smart Scheduler Admin tab.

1. Open to the Events (Admin) app.
2. Click the Smart Scheduler Admin tab.
3. Click the Configuration Settings tab.
4. Set **Select platform for email notification** to “SendGrid.”
5. Select an email address in the **From Email Address** field.
6. Click **Update Settings**.  

![Set Email Notifications](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Set%20Email%20Notifications.png)

### Functionality

- **Allow Schedule creation with SendGrid** can only be toggled on/off if the **SendGrid API Key** field contains a value.
- The **SendGrid API Key** must be added to the BT Base Admin app before users can select "SendGrid" in the **Select platform for email notification** field.
- Users cannot remove/modify the API Key if the **Allow Schedule creation with SendGrid** setting is toggled "ON."
- Users cannot remove/modify the API Key if there is an active email scheduled job with SendGrid selected as the from email.
- Users cannot remove/modify the API Key when SendGrid is selected as the platform for email notification in the Email Notification Settings.

## Schedule SendGrid Emails

Use the Smart Scheduler to schedule SendGrid emails.

1. Make sure **Allow Schedule creation with SendGrid** is set to “On.”
2. Open the relevant Event record.
3. Click the Communications tab. (If you don’t see the Communications tab, click [here](https://docs.blackthorn.io/docs/msg-ss-add-event-scheduler-component-event-record) to learn how to add it.)
4. Click **New Message**.

### Recipients Section

1. Select Schedule “an Email.”
2. Select “Event Attendees” or “Session Attendees.”
3. Enter a **Schedule Name**.
4. Select “SendGrid.”  

![Salesforce or SendGrid](https://cdn.document360.io/f977eec0-500f-40a3-b663-724a51f78075/Images/Documentation/Salesforce%20or%20SendGrid.png)
5. Select a **From Email Address**.
6. Select a **To Email**.
7. Choose an **Attendee Filter**.
  - If you set **Attendee Filter** = “Attendance Status”, select the relevant options in the **Attendance Status** field.
  - If you set **Attendee Filter** = “Registration Status”, select the relevant options in the **Registration Status** field.
8. There must be at least one recipient listed in **Total Recipients**.
9. If a zero is listed under **Total Recipients**, check that you have the correct status selected and review the Attendees that should have the chosen status.
10. Confirm that the amount under **Email Balance** is greater than the number of **Total Recipients**.
11. Click **Next**.

### Schedule Section

1. Choose one of the three options below to schedule your email.
  - Send the email at a specific date and time
    - Choose the specific date and time in the **Select a Date / Time** fields.
  - Send the email X Minutes/Hours/Days After/Before the selected trigger.
    - Enter the number.
    - Choose “Days”, “Hours”, or “Minutes”.
    - Select “Before” or “After”.
    - Choose “Event Start Date/Time”, Event End Date/Time”, “Event Attendee Registration Date”, or “Event Attendee Created Date”.
  - Select **Now** to send the email two minutes after the email is scheduled.
2. Click **Next**.

### Message Section

1. In the **Email Template** field, search for an existing Email Template or click **Create New** to create a new one.
2. Click **Next**.

### Send Test Section

1. Enter a **Test Email**. Make sure to use an email that can be checked easily. Using your email is a good option.
2. Select a **Test Record**.
3. Click **Send Test**.
4. After you receive the success message, click **Schedule**.