Docs
Emails

Emails

Create and manage your emails.

Please do not abuse the free email service. If any illegal or malicious activities are discovered, the account will be banned. If you need help, please contact us.

Overview

We provide a free email service for users to send and receive emails. Users can generate a unique email address and use it to send and receive emails.

Start using the email service at https://wr.do/emails !

How it works

We use resend to send emails. Resend is a free email service that allows users to send and receive emails.

For receive emails, we use the cloudflare email worker to receive emails and forword emails.

It's powerful and stable. And it's easy to use.

Expiration

The email will never be deleted unless you delete it manually.

once deleted, it cannot be recovered. All emails in inbox will be deleted at the same time.

Limit

The maximum number of email addresses is 1000.

Each email address can receive unlimited emails

For send emails, the maximum number of emails is 10 per day.

API Reference

The Email API allows you to create and manage email addresses and retrieve received emails in your inbox.

Create Email Address

The POST /api/v1/email endpoint allows you to create a new email address.

curl -X POST \
  -H "Content-Type: application/json" \
  -H "wrdo-api-key: YOUR_API_KEY" \
  -d '{
    "emailAddress": "your-suffix@wr.do"
  }' \
  https://wr.do/api/v1/email

Request Body (Params)

{
  "emailAddress": "your-suffix@wr.do" // required, suffix must be at least 5 characters
}

Authorization Header

  • wrdo-api-key: You can use your API key to authenticate your requests. You can find your API key in your account settings. Add the header wrdo-api-key: YOUR_API_KEY to your request.

Response

On success (Status 201):

{
  id: string;
  userId: string;
  emailAddress: string;
  createdAt: Date;
  updatedAt: Date;
  deletedAt: Date | null;
}

Error Responses

  • 401 Unauthorized: Missing or invalid API key
  • 400 Bad Request: Missing email address or invalid suffix (less than 5 characters)
  • 403 Forbidden: Email address quota has been reached
  • 409 Conflict: Email address already exists
  • 500 Internal Server Error: Server error

Get Email Inbox

The GET /api/v1/email/inbox endpoint allows you to retrieve all forwarded emails for a specific email address.

You must create a email address before you can get the inbox.

curl -X GET \
  -H "wrdo-api-key: YOUR_API_KEY" \
  "https://wr.do/api/v1/email/inbox?emailAddress=your-suffix@wr.do&page=1&size=10"

Query Parameters

  • emailAddress: The email address to get the inbox for (required)
  • page: Page number for pagination (optional, default: 1)
  • size: Number of emails per page (optional, default: 10)

Authorization Header

  • wrdo-api-key: You can use your API key to authenticate your requests. You can find your API key in your account settings. Add the header wrdo-api-key: YOUR_API_KEY to your request.

Response

On success (Status 200):

{
  "list": [
    {
      id: string
      from: string
      fromName: string
      to: string
      subject: string | null
      text: string | null
      html: string | null
      date: string | null
      messageId: string | null
      replyTo: string | null
      cc: string | null
      headers: string | null
      attachments: string | null
      readAt: Date | null
      createdAt: Date
      updatedAt: Date
    },
  ],
  "total": 25
}

Error Responses

  • 401 Unauthorized: Missing or invalid API key
  • 400 Bad Request: Missing emailAddress parameter
  • 404 Not Found: Email address not found or has been deleted
  • 500 Internal Server Error: Server error

Delete Email Address

The DELETE /api/v1/email endpoint allows you to delete a specific email address.

curl -X DELETE \
  -H "wrdo-api-key: YOUR_API_KEY" \
  -d '{
    "emailAddress": "your-suffix@wr.do"
  }' \
  "https://wr.do/api/v1/email"