SendGrid Integration

Overview

To send emails through gaiia, you need to connect an external email provider. This guide walks you through setting up SendGrid as your email delivery service. You’ll create a SendGrid account, authenticate your domain, and connect it to gaiia using an API key and sender email.

Setting up your SendGrid integration

Before you can send emails through gaiia, you need to connect your SendGrid account and configure the basics.

Step 1 – Create your SendGrid account

If you don’t already have a SendGrid account, start by creating one here:
https://signup.sendgrid.com/

Step 2 – Authenticate your domain

Domain authentication ensures that your emails appear trusted and don’t get flagged as spam.
Follow SendGrid’s official guide to set up domain authentication:
https://docs.sendgrid.com/ui/account-and-settings/how-to-set-up-domain-authentication

Step 3 – Connect SendGrid in gaiia

Once your domain is authenticated, you can link SendGrid to gaiia.

1. Go to the Integrations page: https://app.gaiia.com/[my tenant slug]/admin/integrations
2. Click on Install next to SendGrid
3. Provide the required information:
   • SendGrid API Key:
     You can generate or manage your API keys from this page:
     https://docs.sendgrid.com/ui/account-and-settings/api-keys
   • Default sender email:
     This will be the address emails are sent from. Use a format like support@mydomain.com
     You can also include a custom name like:
     My custom name <support@mydomain.com>

You can update this configuration at any time from the Integrations page.
Important: You’ll need to re-enter your API key and default sender email when updating the integration. gaiia currently doesn’t support editing a single field—both the sender email and API key must be filled in again.