Emailer

Purpose

Packaging SMTP(send only) APIs to a choosable option is the goal here, then to have a tiny server that picks 1 provider and serves as HTTP endpoint so the other microservices that belong to you can make email requests.

Supported providers

• Brevo (highly recommended)
• Resend
• Postmark
• Mailchimp
• Mailtrap
• Mailjet
• Mailgun
• Fastmail
• Sendgrid

Note: Anything that only uses oauth2 like zoho does will not be implemented here for foreseeable future

Getting Started

  export API_KEY=<SECRET_API_KEY>
  export PROVIDER=brevo
  go run ./cmd/emailer/main.go -debug

Kick the server by after having PROVIDER and API_KEY env variables then run go run ./cmd/emailer/main.go

API

This endpoint allows you to send an email by providing the necessary email details in the request body as JSON.

• Method: POST
• URL: /email
• Request:

  • {
      "from": "sender@example.com",
      "to": ["recipient1@example.com", "recipient2@example.com"],
      "bcc": ["bcc1@example.com", "bcc2@example.com"],
      "cc": ["cc1@example.com", "cc2@example.com"],
      "subject": "Test Email",
      "htmlContent": "<p>This is a test email in HTML format.</p>",
      "textContent": "This is a test email in plain text format."
    }

• Response:
  • 200 Email successfully sent
  • 400 Encoding error or Failed to validate
  • 500 Failed to send email (check logs something went wrong with the provider)

  curl -X POST http://localhost:5555/email \
  -H "Content-Type: application/json" \
  -d '{
    "from": "sender@example.com",
    "to": ["recipient@example.com"],
    "subject": "Test Email",
    "htmlContent": "<p>This is a test email in HTML format.</p>",
    "textContent": "This is a test email in plain text format."
  }'