How to Send a Test Email in SendGrid (and Read the Result Right)

Log in to the Twilio SendGrid console, go to Marketing then Single Sends, click the title of the Single Send you want to test, type addresses under Test Your Email, and click Send Test Message.

Before you read what arrives, know that SendGrid changed it. The documentation is direct about this: Twilio SendGrid prepends Test - to the subject line, so recipients know the message is a test. That single behavior makes a quick test send unusable for judging the one part of your email a filter reads first. Your subject line is a scored input, and the subject line in your inbox is not the subject line you are about to send.

SendGrid is unusual among sending platforms in having a genuine spam test in the product at all. Most do not. That makes it worth being precise about what each of its three test surfaces actually measures.

SendGrid featureWhat it measuresCost
Send Test MessageLayout and content, with Test - added to the subjectFree, no credits
Spam TestThe message against filtering criteria, as a reportOne Email Testing credit
Inbox Rendering TestScreenshots across email clients and devicesEmail Testing credits
Link validationWhether every URL in the message resolvesFree, bundled with rendering

Send a quick test email in SendGrid

The quick path lives on the Single Send itself and needs no setup.

  1. Log in to the Twilio SendGrid console.
  2. Go to Marketing, then Single Sends.
  3. Click the title of the Single Send you want to test.
  4. Under Test Your Email, type the addresses that should receive the message.
  5. Click Send Test Message.

What lands is your content with a modified subject. Use it to check the layout, the copy and whether images load. Do not use it to evaluate the subject line, and do not draw conclusions about where a real campaign would land from where this one landed.

Run a Spam Test or an Inbox Rendering Test

The scored tests sit behind a different path, which is the most common reason people conclude SendGrid has no spam test.

  1. Go to Marketing, then Single Sends, then Settings, then Test Your Email.
  2. Click the title of the Single Send you want to test.
  3. Click Create Test.
  4. On the Select testing options page, choose the Spam Test, the Inbox Rendering Test, or both.
  5. Pick the clients you want rendered.
  6. Click Run Test.

SendGrid's documentation for this was last updated on 16 March 2026.

Email Testing credits expire every month

Both the Spam Test and the Inbox Rendering Test draw on Email Testing credits, and SendGrid states that all of them expire at the end of each month, whether they arrived with your plan or were purchased as an add-on package. How many you get depends on your Marketing Campaigns or Email API plan.

There is one free check in the set worth using every time. Every inbox rendering test run includes a link validation test that checks the validity of all URLs in the message, and SendGrid confirms these do not consume credits. That is not a trivial win: across messages tested with Unspam this year, 80% are clean of broken links, which means one campaign in five ships with a link that does not resolve.

A Spam Test scores the message, not the destination

A spam test reads what you wrote. It can tell you that your HTML is malformed, that a phrase is heavily weighted, that your text-to-image ratio is poor. Those are properties of the file.

Inbox placement is decided somewhere else, using inputs a content scan has no access to: your sending domain's reputation at that specific provider, your complaint rate there over recent weeks, how that provider's own users have engaged with your mail, and the authentication on the message as delivered. The same message routinely lands in the inbox at one provider and in spam at another, on the same day, from the same sender.

That gap is the reason a clean score and a placement problem coexist so often. Of the campaigns run through Unspam so far this year, 65% of emails reach the primary inbox, and the messages making up the other share are not, as a rule, badly written. The Unspam deliverability benchmark tracks the split. For what a score is and is not measuring, SpamAssassin scoring covers the mechanics in detail.

SendGrid Campaigns is now Single Sends, and the old docs are gone

Two changes inside about a year make most older SendGrid tutorials wrong in ways that are hard to spot. What used to be called a campaign is now a Single Send, and the documentation moved from docs.sendgrid.com to twilio.com/docs/sendgrid. Separately, SendGrid retired its free Email API and free Marketing Campaigns plans starting 27 May 2025.

If a guide tells you to open Campaigns, or links to a docs.sendgrid.com URL, it predates both and its click paths will not match your console.

Testing an API send, where the console tools do not reach

The test features described above are attached to Single Sends. If you send through the SendGrid API, none of them applies to your traffic, and the honest test is the message itself.

Send through your normal API path to an external address with sandbox mode switched off, then open the Activity Feed. The event to look for first is Dropped, which means SendGrid never attempted delivery at all. The usual cause is that the address sits on one of your own suppression lists from an earlier bounce or complaint, and no amount of filter analysis will explain a message that never left.

When you need a real send instead

Once the layout is right and the Spam Test is clean, the questions still open are all about the live send: whether your DKIM signature aligns to your own domain, whether your tracking links resolve through a domain with a clean history, and where the message actually lands per provider.

The SendGrid deliverability guide covers that setup, including the suppression behavior that quietly swallows test recipients. For the placement question, an inbox placement test delivers your campaign to seed mailboxes at Gmail, Outlook, Yahoo and five other providers and reports where each copy was filed.

When you have the message you plan to send, run it through the free Unspam spam test as it will actually go out, subject line included.

Frequently asked questions

How do I send a test email in SendGrid?

Log in to the Twilio SendGrid console and go to Marketing, then Single Sends. Click the title of the Single Send you want to test. Under Test Your Email, type the addresses that should receive the message, then click Send Test Message. Note that what arrives is not byte-identical to your campaign, because SendGrid alters the subject line on the way out.

Why does my SendGrid test email say Test in the subject line?

Because SendGrid puts it there. The documentation states plainly that Twilio SendGrid prepends Test followed by a hyphen and a space to the subject line, so that recipients know they received a test rather than the real send. It is helpful for a review round and unhelpful for anything else, because your subject line is one of the inputs a filter scores. Any judgment you form about the subject from a quick test send is a judgment about a subject line you are not going to send.

What is the difference between SendGrid's Spam Test and its Inbox Rendering Test?

They answer different questions and are bought with the same currency. The Spam Test evaluates your message against filtering criteria and returns a report. The Inbox Rendering Test produces screenshots of how the message displays across email clients and devices. Both consume Email Testing credits. You select either or both on the Select testing options page after clicking Create Test.

How do SendGrid Email Testing credits work?

Both Inbox Rendering Tests and Spam Tests draw on a pool of Email Testing credits, and SendGrid states that all of them expire at the end of each month, whether they came with your plan or were bought as an add-on package. How many you get depends on your Marketing Campaigns or Email API plan. Unused credits do not roll forward, so a month of careful testing and a month of none cost the same.

Does the link validation test use credits?

No. SendGrid includes a link validation test with every inbox rendering test run, checking the validity of all URLs in the message, and its documentation says these tests do not use Email Testing credits. It is the cheapest check in the product and it catches a genuinely common failure: across messages tested with Unspam this year, 20% still contain a broken link.

Where did SendGrid Campaigns go, and why do the old docs 404?

Two changes landed close together. Marketing Campaigns was reorganized so that what people called a campaign is now a Single Send, and the documentation moved from docs.sendgrid.com to twilio.com/docs/sendgrid. Separately, SendGrid retired its free Email API and free Marketing Campaigns plans starting 27 May 2025. Guides written before those changes point at menus and URLs that no longer exist, which is worth checking before you follow one.

Does a passing SendGrid Spam Test mean my email will reach the inbox?

No. A spam test scores the message. Inbox placement is decided per mailbox provider, using signals a content scan cannot see: your domain and IP reputation at that provider, your recent complaint rate there, how that provider's subscribers have engaged with your mail, and your authentication on the live send. A message can score cleanly and still be filed in spam at one provider and delivered at another, which is why placement has to be measured per provider rather than inferred from a score.

How do I test a message sent through the SendGrid API rather than a Single Send?

The console test tools are attached to Single Sends, so an API sender does not have them. Send the message through your normal API path to an external address instead, with sandbox mode off, then read the Activity Feed to confirm what happened. A Dropped event there means SendGrid never attempted delivery, usually because the address is on one of your own suppression lists from an earlier bounce or complaint, and that is worth ruling out before you conclude anything about filtering.

See where your campaign actually lands.

Start a free spam test Inbox placement test