Set up SendGrid

Before you start

Before connecting SendGrid to Mailrith, complete the following in your SendGrid account:

• Verify your sender identity. In SendGrid, verify either a single sender email address or a full domain. Domain authentication is strongly recommended — it improves deliverability and allows you to send from any address on that domain.
• Create an API key with send permission. In SendGrid, go to Settings → API Keys and create a key with at minimum Mail Send access. A restricted key scoped only to mail sending is safer than using a full-access key.
• Note your Event Webhook signing key (optional). If you want to validate webhook payloads for security, you can find this in SendGrid's Event Webhook settings after you configure the endpoint.

Mailrith fields

When creating a SendGrid connection in Mailrith, fill in the following fields:

• API Key: the SendGrid API key you created with Mail Send permission.
• From name: the display name that appears in the recipient's inbox — for example, "Acme Team".
• From email: the email address in the From field. Must match your verified sender identity in SendGrid (either a verified single sender or an address on a domain-authenticated domain).

SendGrid setup

1. In SendGrid, go to Settings → API Keys and create or copy an API key with Mail Send permission.
2. In Mailrith, create a new connection, select SendGrid, and enter the API key, From name, and From email.
3. Save the connection and use Send test email to verify credentials and inbox delivery before going live.

Event webhook

SendGrid uses a single Event Webhook that delivers all delivery events — including bounces, spam reports, unsubscribes, opens, and clicks — to one endpoint. Mailrith only processes the bounce and spam report events to update subscriber statuses.

To configure the webhook:

1. In Mailrith, open the connection row and click View webhooks. Copy the webhook URL.
2. In SendGrid, go to Settings → Mail Settings → Event Webhook.
3. Paste the Mailrith URL as the HTTP Post URL. Enable at minimum the Bounce and Spam Report event types.
4. Save the settings. SendGrid will start sending events to Mailrith immediately.

SendGrid sends events for all messages sent through your account, not just those sent from Mailrith. Mailrith only processes events that match outgoing emails it initiated — events from other SendGrid senders are ignored.