Send transactional and marketing email, and manage contacts and lists, from any Windmill script, flow or app.
What you can do with SendGrid
Complete, deployable projects built around SendGrid — the fastest way to get something real running.
Set up in 3 steps
Create an API key
At app.sendgrid.com, open Settings then API Keys and create one. Copy it — it is shown only once.
Add the resource in Windmill
Open Resources, add a resource of type sendgrid, and paste the key.
Run your first script
Fork the send email script below. The sender address must be verified in SendGrid first, or the call is rejected.
Scripts
Building blocks, if none of the projects above fit. Fork one, run it, or call it as a step inside your own flow.
Add Email to Global Suppression
List Blocks
Delete Contacts
Delete Bounces
Delete Blocks
Get a Block
List Global Suppressions
Delete Global Suppression
Get A Global Suppression
Delete List
Send Email Multiple Recipients
Send Email Single Recipient
Remove Contact From List
Validate Email
Get All Bounces
Create Contact List
Search Contacts
Add or Update Contact
Get Contact Lists
Get A Contact List
Get Contacts Job Status
Get A Bounce
Flows
Multi-step workflows that already wire SendGrid to something else.
Resource type
sendgrid — the shape of the credential every script on this page expects.
| Field | Type | Required | What it is |
|---|---|---|---|
| token | string | Yes | API token |
Questions
My send is rejected as a forbidden sender
SendGrid only sends from a verified sender identity. Verify the address or the domain before using it as the from field.
Full access or restricted?
Restricted keys let you grant Mail Send alone, which is all most scripts need. Prefer that to a full access key.
Is my key stored on the hub?
Never. It lives only in your own Windmill workspace, encrypted at rest.