mail-worker

mail-worker is a robust Cloudflare Worker built for sending emails with AWS SES and Bun.

Development

Install all dependencies.

bun install

Usage

POST / (send email to recipient(s))

Request Headers

name	type	description
Authorization	optional	AUTH_TOKEN environment variable

Parameters

name	type	data type	description
to	required	string[]	recipient's email address(es)
from	required	string	sender's email address
subject	required	string	email subject
html	required	string	email content

Responses

http code	content-type	response
200	text/plain	Email sent!
400	text/plain	Invalid request!
401	text/plain	Unauthorised! Please check your token in the request.
500	text/plain	Failed to send email!

Example cURL

curl $MAIL_WORKER_ENDPOINT -H "Content-Type: application/json" -d \
'{
   "to": ["test@test.com"],
   "from": "test@test.com",
   "subject": "test",
   "html": "test"
 }'

Example cURL with Authentication

curl $MAIL_WORKER_ENDPOINT \
  -H "Authorization: $AUTH_TOKEN" \
  -H "Content-Type: application/json" -d \
'{
   "to": ["test@test.com"],
   "from": "test@test.com",
   "subject": "test",
   "html": "test"
 }'

Setup

Environment

Your worker must have the following environment variables.

echo $AWS_REGION | npx wrangler secret put AWS_REGION
echo $AWS_ACCESS_KEY_ID | npx wrangler secret put AWS_ACCESS_KEY_ID
echo $AWS_SECRET_ACCESS_KEY | npx wrangler secret put AWS_SECRET_ACCESS_KEY

Authentication

Optionally, you may secure your endpoint by setting the following environment variable.

echo $AUTH_TOKEN | npx wrangler secret put AUTH_TOKEN

Verify Email

To use any sender email, the email must first be verified. The verification will require the following environment variables. You may populate your environment with the following.

{
  echo "AWS_REGION=$AWS_REGION"
  echo "AWS_ACCESS_KEY_ID=$AWS_ACCESS_KEY_ID"
  echo "AWS_SECRET_ACCESS_KEY=$AWS_SECRET_ACCESS_KEY"
} >> .env

Now, pipe your email to the verify-email script.

echo $EMAIL_ADDRESS | bun verify-email