How it works

From email to Drupal draft in four steps

The module exposes a webhook endpoint. Mail2Draft calls it when a new email matches your flow.

1

Install the module

Install from drupal.org/project/mail2draft or via Composer. The module lives in /modules/contrib/mail2draft. Enable it under Extend or with Drush.

2

Configure your integration & Copy your webhook URL

After enabling the module, go to Configuration → Mail2Draft. Your webhook endpoint URL is shown there — copy it.

3

Paste it into your Mail2Draft Flow

In your Mail2Draft account, open a Flow and paste the webhook URL into the Output section. Optionally set a Bearer token to secure the endpoint.

4

Send an email — draft appears

Send an email with your subject tag to your Mail2Draft address. A draft node will appear in Drupal's content overview within seconds.

Webhook payload

What the module receives

Mail2Draft sends a structured JSON POST. The module maps these fields to a Drupal node automatically.

POST https://yoursite.com/mail2draft/webhook

{
  "messageId":    "<abc123@mail2draft.eu>",
  "subject":      "[blog] My article title",
  "fromAddress":  "author@example.com",
  "fromName":     "Jane Author",
  "bodyText":     "Plain text body of the email...",
  "bodyHtml":     "<p>HTML body of the email...</p>",
  "contextTag":   "blog",
  "promptTemplate": "Turn this email into a blog post draft.",
  "receivedAt":   "2025-06-01T09:30:00+00:00",
  "attachments":  []
}

The module responds with {"title": "Node title", "url": "https://yoursite.com/node/123"} so Mail2Draft can log the draft URL and reply to you.

Download

Get the module

The module is free and open source. No licence key required.

mail2draft_drupal

Drupal 10 & 11 · Free · Open source

⬇ Get on drupal.org

Or install via Composer:

composer require drupal/mail2draft
drush en mail2draft -y

FAQ

Common questions

Which content types does the module create drafts for?

By default the module creates article nodes. You can configure the target content type and field mappings in the module settings at /admin/config/mail2draft.

Is authentication supported?

Yes. You can set a Bearer token in the module settings. Mail2Draft will include it in every request as an Authorization: Bearer ... header.

Does the module store emails?

No. The module processes each webhook payload immediately and does not store raw email content. Only the resulting node is persisted.

Do I need a Mail2Draft subscription?

Yes — the module is free but requires a Mail2Draft account to send webhook payloads to your Drupal site.

Ready to automate your Drupal content?

Create your free Mail2Draft account, set up a flow, and install the module. Drafts in minutes.

Create free account Download module