SendGrid

Use the SendGrid connector when your team already manages sender identity, domain authentication, reputation, or billing in SendGrid.

Before you start

• Create a restricted SendGrid API key with mail send permissions.
• Authenticate your sending domain in SendGrid.
• Keep access to Event Webhook settings.

Setup

sequenceDiagram
  participant Admin as Workspace admin
  participant MG as GenieOS
  participant SG as SendGrid
  participant Recipient as Recipient

  Admin->>SG: Create restricted API key
  Admin->>MG: Install SendGrid connector
  MG->>SG: Send test via Mail Send API
  SG->>Recipient: Deliver message
  SG->>MG: Event Webhook callbacks
  MG->>Admin: Show normalized timeline

1. Open Settings -> Connectors and choose SendGrid.
2. Paste the API key and configure sender defaults.
3. Copy the webhook URL and signing details from GenieOS.
4. Add the Event Webhook in SendGrid and enable delivery, bounce, spam report, open, click, and unsubscribe events as needed.
5. Send a test message.

Capabilities

Webhooks and suppressions

SendGrid spam reports, hard bounces, and unsubscribe events should flow back to GenieOS when enabled in the Event Webhook. GenieOS checks local suppressions before every SendGrid handoff.

Troubleshooting

• 403 responses usually mean the API key lacks Mail Send permissions.
• Sender errors usually mean the from domain is not authenticated in SendGrid.
• Missing event data usually means the Event Webhook does not include the relevant event type.