How to Set Up SendGrid: Step-by-Step Guide for 2026
How to set up SendGrid step by step: create an account, verify your sender and domain, make an API key with the right permissions, and send a test email.
Quick answer
Here’s how to set up SendGrid: create a free trial account, authenticate your domain under Settings, then Sender Authentication, and create an API key that can only send mail. Then ask Claude Code to store the key safely and add the sending code to your project. Finally, send a test email and check it in SendGrid’s Activity page.
Last checked: October 2026
On this page
Claude Code suggested SendGrid for your project’s emails, and now you’re looking at a dashboard full of settings. This guide shows how to set up SendGrid step by step, in the order that works, so you can get your first email out and get back to building.
It’s for people building SaaS products, sites and tools with Claude Code who don’t write the code themselves. You do the account and domain steps in SendGrid; Claude Code adds the key and sending code.
SendGrid sends transactional emails: automatic, one-to-one messages such as a welcome email, a password reset or a receipt.
How do I create a SendGrid account?
Go to SendGrid’s sign-up page, choose Start for free, and fill in your name, email address and password. No credit card is needed for the free trial.
- Enter your first name, last name, email address and password, tick the captcha and terms boxes, and choose Continue.
- SendGrid emails you a code. Paste it into the “Let’s get your email verified” box.
- Verify your phone number by text or voice call. SendGrid uses it for two-factor authentication, an extra login check.
- Copy the recovery code it shows you and keep it somewhere safe. It appears once, and you’ll need it if you lose access to your phone.
- Fill in “Tell Us About Yourself” (company name, website and phone number).
- SendGrid then offers to authenticate a domain. You can do it now or choose Skip to dashboard and follow the next section.
If you can’t get into your account after signing up, wait 30 minutes and check your inbox. SendGrid sometimes reviews new accounts and emails you if it needs more information.
Here’s what you’re signing up for:
| Plan | Price | What you get |
|---|---|---|
| Free trial | $0 for 60 days | 100 emails a day |
| Essentials | From $19.95 a month | Volume-based, for smaller senders |
| Pro | From $89.95 a month | Higher volume, dedicated IP addresses |
| Premier | Custom pricing | Very high volume |
Prices checked October 2026 on SendGrid’s pricing page.
How do I verify my sender and authenticate my domain?
SendGrid won’t send from an address until you prove it’s yours. You can verify one address (a single sender) or your whole domain (domain authentication). For a live project, authenticate your domain.
Both options live in the same place: Settings, then Sender Authentication.
Option 1: Verify a single sender
- Under Single Sender Verification, choose Verify a Single Sender.
- Fill in the form: from name, from email address, reply-to address, your company’s postal address and a nickname only you can see.
- Choose Create, then open the email SendGrid sends to that address and click the link.
If you enter an address from a large inbox provider such as Gmail, SendGrid shows a warning. Use an address on your own domain, such as hello@yourcompany.com.
Option 2: Authenticate your domain
This lets you send from any address on your domain. It means adding a few DNS records. DNS (the domain name system) is the internet’s address book, and its records are settings kept wherever your domain is managed, such as your registrar or Cloudflare.
- In the Domain Authentication section, choose Get Started.
- Pick your DNS host from the list, or choose I’m not sure.
- When asked whether to brand your links, choose No for now. You can add it later.
- Type your domain on its own, such as yourcompany.com, with no “www”.
- Open Advanced Settings and leave Use automated security turned on.
- Choose Next. SendGrid shows the records to add.
With the recommended settings, you’ll usually see four records:
| Type | What it does | Where the values come from |
|---|---|---|
| CNAME | Points your domain’s mail settings to SendGrid | Copy exactly from SendGrid |
| CNAME | Lets SendGrid prove the email came from you | Copy exactly from SendGrid |
| CNAME | A second record for the same check | Copy exactly from SendGrid |
| TXT | Tells inboxes what to do with emails that fail these checks | Copy exactly from SendGrid |
A CNAME record points one name to another. A TXT record stores a short piece of text. Add each one in your DNS host’s settings, then return to SendGrid and choose Verify. Changes can take up to 48 hours to show up.
Two common snags:
- The domain gets added twice. Many DNS hosts add your domain to the record name automatically. If SendGrid shows em1234.yourcompany.com, type only em1234.
- Automatic setup isn’t offered. SendGrid can add the records for you only if your domain is with GoDaddy and link branding is off. Otherwise, you add them by hand.
Our guide on how to verify a domain for email covers the DNS step in more detail.
How do I create an API key with the right permissions?
Go to Settings, then API Keys, and choose Create API Key. Give it a name, choose Custom Access, and turn on only the permission to send mail.
An API key is a long secret password that lets your project use SendGrid without your login details. Anyone who has it can send email as you, so keep it private.
- Type a name you’ll recognize, such as “My SaaS – sending”.
- Choose Custom Access (older guides call this “Restricted Access”).
- Find Mail Send in the list and set it to Full Access. Leave everything else off.
- Choose Create & View, then click the key to copy it.
SendGrid shows the key once. If you lose it, it can’t be recovered: delete it and create a new one.
A key that can only send mail does less harm if it ever leaks: it can’t change your account or see your billing.
How do I add the API key to my project with Claude Code?
Hand the key to Claude Code and ask it to store it safely and add the sending code. You don’t write any code.
I’ve set up SendGrid for my transactional emails. My domain yourcompany.com is authenticated, and I want emails to come from hello@yourcompany.com with the name “Your Company”. I’ve created an API key that can only send mail. Please store it safely in my project, keep it out of anything public, and add what’s needed to send email through SendGrid. Ask me for the key when you’re ready.
Expect Claude Code to put the key in an environment variable, a setting your project reads when it runs, kept outside the code. On your computer that’s usually a .env file, a small private settings file that shouldn’t be shared. It will also add a small piece of sending code.
Your live project needs the key too. Add the same key in your hosting provider’s environment variable settings. On Vercel, changes only apply to new deployments, so redeploy afterward.
My project is hosted on Vercel. Tell me exactly what to name the SendGrid key in my hosting settings, and remind me to redeploy afterward.
For more on keeping keys safe, see where to put API keys.
How do I send a test email?
Ask Claude Code to send one test email to your own address, then check your inbox and SendGrid’s Activity page.
Please send a test email through SendGrid to me at hello@yourcompany.com with the subject “SendGrid test”. Tell me whether SendGrid accepted it, and if it didn’t, tell me what the error means in plain English.
If it arrives, you’re set up. If not, open Activity in SendGrid and search for your address to see what happened, such as delivered, deferred or bounced. On the free trial and Essentials plan, it keeps 3 days of history.
| What you see | What it usually means | What to do |
|---|---|---|
| An error about the from address | The address isn’t verified or on your authenticated domain | Use your verified address, or complete domain authentication |
| An error about the key or permissions | The key was copied wrongly or can’t send mail | Create a new key with Mail Send turned on |
| Nothing in Activity at all | The request never reached SendGrid | Ask Claude Code to check the key name in your settings |
| Emails stop after a while | Trial ended or you hit 100 a day | Check your plan in SendGrid |
Our guide to testing your emails before users see them has a fuller checklist.
How is SimpleSends different for people who don’t code?
SimpleSends is a transactional email service like SendGrid, built for people who build with Claude Code but don’t write code. You still set up the same building blocks: an account, a verified sending domain, a secret key and sending code in your project. The difference is what working with it is like after that.
SendGrid suits people who write code or want to edit code themselves, and teams sending very high volumes. Its console and docs are written for developers.
With SimpleSends:
- The sign-up, the connect steps and the help are written in plain English, without developer jargon.
- Everything after sign-up happens in the chat. You don’t need a dashboard for day-to-day work. You brief Claude Code the way you’d brief a person.
- Claude Code handles every email. It designs, writes, builds and changes every transactional email, so “set up all my transactional emails” is a reasonable brief.
- Problems get sorted in plain English. Claude Code can read your send logs and delivery status through SimpleSends, so it can tell you whether an email went out and help work out why one didn’t.
Claude Code talks to SimpleSends through a connector that uses MCP, a standard way for AI tools to connect to other services. The connector is for building and testing; once live, your project sends real emails directly through SimpleSends.
To connect SimpleSends:
- Sign up on the SimpleSends website and follow the steps there to set up the email address you’ll send from. To send from your own domain, this includes adding a few DNS records where your domain is registered.
- In Claude Code, open Customize, then Connectors, choose Add, then Add custom connector. Name: SimpleSends. MCP server URL: https://mcp.simplesends.com/mcp
- When Claude prompts you to connect, log in to SimpleSends.
- Back in the Claude Code chat, tell Claude Code:
I’ve connected SimpleSends for all transactional email.
It takes it from there, including adding what your project needs to send email.
Want to see how working with SendGrid inside Claude Code looks day to day? Read our guide to using SendGrid with Claude Code.
Frequently asked questions
Can I use a Gmail address as my SendGrid sender?
You can try, but SendGrid shows a warning if you enter an address from a large inbox provider such as Gmail, because those emails may fail the provider’s security checks and get rejected. Sending from your own domain, such as hello@yourcompany.com, after authenticating it, is the reliable option.
Why do my SendGrid emails say “via sendgrid.net”?
That tag appears when your domain isn’t authenticated yet. Once you add SendGrid’s DNS records and the domain shows as verified, SendGrid removes it, and your emails show only your own address. If you still see it, check that your from address uses exactly the domain you authenticated.
Is there a SendGrid connector for Claude Code?
Twilio, which owns SendGrid, offers a connector in Claude’s connector directory (search for Twilio). As of October 2026 it’s in public beta and read-only: it helps Claude look up SendGrid’s documentation, but it doesn’t change account settings, create keys or send email for you.
What happens when the SendGrid free trial ends?
The free trial lasts 60 days. To keep sending after that, you need a paid plan. The Essentials plan starts at $19.95 a month as of October 2026. You can upgrade at any time from your SendGrid account, so it’s worth doing before your trial runs out if your project is live.
Should my project use SendGrid’s SMTP or its API?
SendGrid supports both, and both use the same API key. SMTP is the older, standard way computers pass email along. The API is a direct connection built for software. For a project built with Claude Code, the API is usually the simpler choice. If you’re unsure which one your project uses, ask Claude Code.
Sources (10)
- SendGrid Email API pricing(checked October 4, 2026)
- How to Create a SendGrid Account(checked October 4, 2026)
- Authenticate a single sender (SendGrid Docs)(checked October 4, 2026)
- Configure domain authentication (SendGrid Docs)(checked October 4, 2026)
- API Keys (SendGrid Docs)(checked October 4, 2026)
- API Key permissions (SendGrid Docs)(checked October 4, 2026)
- Two-factor authentication (SendGrid Docs)(checked October 4, 2026)
- Email Activity Feed (SendGrid Docs)(checked October 4, 2026)
- Twilio MCP server(checked October 4, 2026)
- Environment variables (Vercel Docs)(checked October 4, 2026)
Keep reading
More on The prompt moment →How to Set Up Resend, Step by Step (Non-Developers)
How to set up Resend step by step: create an account, verify your domain, make an API key, add it to your project with Claude Code and send a test email.
7 min read
Resend vs Postmark vs SendGrid for Non-Developers (2026)
Resend vs Postmark vs SendGrid for people who build with Claude Code but don’t code: setup, prices, free plans and how each one connects to Claude.
8 min read
Resend vs SendGrid: Which to Pick If You Don’t Code
Resend vs SendGrid compared for non-developers building with Claude Code: setup steps, free plans, pricing and day-to-day use, checked October 2026.
8 min read