1. Get SendGrid API Key

You can see a list of your SendGrid API keys via the "API Keys" section of your SendGrid account's "Settings" page. If you'd like to use an existing API key, you'll have to get this from whoever set up the key — SendGrid doesn't let you display API keys after they're created. If you want to create a new API key to use with Retool, you can press the "Create API Key" button to create a new key and view it. Store it somewhere safe because SendGrid won't show it to you again!

SendGrid > Settings > API Keys

When you select the API Key Permissions, the methods available will change depending on the access you give this key. If you'd like to send mail through this resource, you'll need to select Full Access here:

2. Add to Retool

Create a new resource in Retool, and select "SendGrid" as the type. Enter your API key in the "Access Token" field. Press "Save" when you're done.

Resources > Add > SendGrid

3. Create queries

You can now select your newly-created SendGrid resource from the Resource dropdown when creating queries in your Retool apps. Please refer to the SendGrid API docs for details on each operation: https://sendgrid.com/docs/API_Reference/api_v3.html.

📘

Verified Senders

SendGrid requires all sender email addresses to be verified before they can be used in the from field of a POST query. You can create a new, verified sender in SendGrid under Marketing > Senders > Sender Management!