MailerSend

Use the MailerSend connector when your team already sends transactional mail through MailerSend and wants GenieOS to own authoring, approvals, schemas, and send audit trails.

Before you start

• Create a MailerSend API token with email sending permissions.
• Verify the sending domain in MailerSend.
• Keep access to the MailerSend dashboard for webhook configuration.

Setup

sequenceDiagram
  participant Admin as Workspace admin
  participant MG as GenieOS
  participant MS as MailerSend
  participant User as Recipient

  Admin->>MS: Create API token
  Admin->>MG: Install MailerSend connector
  MG->>MS: Test token and sending domain
  MG->>MS: Send message via API
  MS->>User: Deliver email
  MS->>MG: Delivery webhook events

1. Open Settings -> Connectors and choose MailerSend.
2. Paste the MailerSend API token.
3. Enter the sending domain and default sender details.
4. Copy the GenieOS webhook URL and signing secret.
5. Add the webhook in MailerSend, then send a connector test.

Capabilities

Webhooks and suppressions

MailerSend webhooks should point at the webhook URL shown in the connector success screen. Enable delivery, bounce, complaint, open, click, and unsubscribe events if they are available in your MailerSend plan.

Troubleshooting

• 401 or 403 during testing usually means the API token is missing required scopes or belongs to the wrong MailerSend workspace.
• Domain errors usually mean the from address does not match a verified MailerSend domain.
• Missing opens and clicks often mean tracking is disabled in MailerSend.