Cloudflare Email Routing

A Raycast extension that allows you to create, list, edit, and delete Cloudflare email aliases directly from Raycast.

🚀 Features

• 📧 Create Email Aliases: Instantly generate random email aliases that forward to your real inbox.
• 📋 List & Search: View and search all your email aliases.
• ✏️ Edit Alias Label: Quickly update the label of any alias.
• 🗑️ Delete Aliases: Remove aliases you no longer need.
• 📋 Quick Copy: Copy email addresses to the clipboard.
• ⚡️ Alias Pooling: Pre-allocate a pool of aliases for even faster creation (optional).

🖼️ Screenshots

📝 Prerequisites

1. Cloudflare Account: A Cloudflare account with a configured domain.
2. Email Routing: Email Routing must be enabled for your domain in Cloudflare.
3. API Token: A Cloudflare API token with the necessary "Email Routing" and "Zone" permissions.

For a detailed guide on setting up your Cloudflare account and obtaining the required credentials, please follow the setup instructions.

🔧 Setup

After installing the extension, you will need to configure the following preferences in Raycast:

• Cloudflare API Key: Your API token with following permissions:

  1. Email Routing Addresses:Edit
  2. Email Routing Rules:Edit
  3. Zone Settings:Read

• Zone ID: The Zone ID for the domain where your email routing is configured.

• Destination Email Address: The real email address where your aliases will forward emails to.

• Pre-allocate Alias Pool (Optional): Enable to pre-create a pool of unused aliases for faster generation.

🔍 Usage

List Email Aliases Command

• View Aliases: See a list of all your active email aliases.
• Search: Search aliases by email address or label.
• Toggle Details: Press ⌘D to view detailed information for an alias.
• Copy Email: Press ⌘C to copy the alias's email address.
• Edit Alias: Press ⌘E to open the edit view for the selected alias.
• Delete Alias: Press Ctrl+X to delete the selected alias (with confirmation).
• Copy Forwarding Address: Press ⌘⇧C to copy the destination email address.

Create Email Alias Command

• Create New Alias: Generate a new, random email alias.
• Add Label: Assign a label to your new alias for organization.
• Use Random Unused Alias: Press ⌘R for quick creation using a pre-allocated alias with a default label.

❓ How It Works

This extension utilizes Cloudflare's Email Routing API to manage forwarding rules. It stores metadata within the rule's name using a specific format: [hide_mail]|<timestamp>|<label>|<description>. This allows the extension to manage aliases without needing a separate database.

🔐 Security

• Your API token and other credentials are stored securely using Raycast's preference system.
• All API calls are made directly from your machine to the Cloudflare API.
• No third-party servers are involved in any part of the process.

🛡️ Privacy

This extension communicates only with the Cloudflare API and Raycast. No user data is collected or sent to any other services.