Skip to content

Add MailKite email provider - #60

Merged
eelcoj merged 1 commit into
Rails-Designer:mainfrom
bucabay:add-mailkite-provider
Aug 31, 2026
Merged

eelcoj merged 1 commit into
Rails-Designer:mainfrom
bucabay:add-mailkite-provider

Conversation

@bucabay

@bucabay bucabay commented Aug 12, 2026

Copy link
Copy Markdown
Contributor

Summary

Adds MailKite as a transactional email provider, backed by MailKite's
POST https://api.mailkite.dev/v1/send JSON API.

What changed

  • New Courrier::Email::Providers::Mailkite provider that maps the standard
    from / to / cc / bcc / reply_to / subject / text / html
    fields to the MailKite send API, authenticating with a Bearer API key.
  • Comma-separated recipients are split into arrays (to, cc, bcc), which
    is what the MailKite API accepts (replyTo stays a single string).
  • Registered the provider in the Courrier::Email::Provider registry.
  • Added provider tests (body formatting, optional-recipient omission, auth
    header, registry availability) and updated the registry coverage test.
  • Documented MailKite in the README provider list.

Usage

Courrier.configure do |config|
  config.email = {
    provider: "mailkite",
    api_key: "mk_live_..."
  }

  config.from = "devs@example.com"
end

OrderEmail.deliver to: "recipient@example.com"

Verification

rake (test + standard) passes: 104 runs, 192 assertions, 0 failures.

Adds a MailKite transactional email provider backed by MailKite's
POST https://api.mailkite.dev/v1/send JSON API (Bearer auth). Maps the
standard from/to/cc/bcc/reply_to/subject/text/html fields and splits
comma-separated recipients into arrays as the API expects.
@bucabay

bucabay commented Aug 27, 2026

Copy link
Copy Markdown
Contributor Author

Hi — friendly bump on this one: it adds a MailKite email provider (a Courrier::Email::Providers::Mailkite mapping to POST /v1/send, registered in the provider registry, with tests and a README entry). Open to any changes or a rebase if that helps review. Thanks for taking a look!

@eelcoj
eelcoj merged commit 1f03ed5 into Rails-Designer:main Aug 31, 2026
1 check passed
@eelcoj

eelcoj commented Aug 31, 2026

Copy link
Copy Markdown
Collaborator

Thanks @bucabay. ❤️ Are you the owner/builder of MailKit? Be sure to add Courrier to your docs for your Ruby users! ✨

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants