SendGrid

Communication API key Windmill docs

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

1

Create an API key

At app.sendgrid.com, open Settings then API Keys and create one. Copy it — it is shown only once.

2

Add the resource in Windmill

Open Resources, add a resource of type sendgrid, and paste the key.

3

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.

Flows

Multi-step workflows that already wire SendGrid to something else.

All flows →

Resource type

sendgrid — the shape of the credential every script on this page expects.

View raw schema →
FieldTypeRequiredWhat it is
tokenstringYesAPI 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.