Messages

Create message

Create/append a new message to a folder. This endpoint accepts standard Nodemailer message format and allows you to specify the target folder, initial flags, and labels. If the target folder doesn't exist, it will be created automatically.

post/v1/messages

Request

Base URL: https://api.forwardemail.net
URL: https://api.forwardemail.net/v1/messages
Auth: HTTP basic

Request body

fromstring email

Sender email address

subjectstring

Message subject

textstring

Plain text content

htmlstring

HTML content

attachmentsobject[]

Message attachments (Nodemailer format)

folderstring

Target folder (defaults to INBOX)

Response

Message created successfully

idstring required

Message ID

root_idstring required

Root message ID for threading

folder_idstring required

Folder ID containing the message

folder_pathstring required

Folder path containing the message

thread_idstring required

Thread ID for conversation grouping

header_message_idstring required

Message-ID header value

is_unreadboolean required

Whether message is unread

is_flaggedboolean required

Whether message is flagged

is_deletedboolean required

Whether message is deleted

is_draftboolean required

Whether message is a draft

is_junkboolean required

Whether message is junk/spam

is_copiedboolean required

Whether message is copied

is_encryptedboolean required

Whether message is encrypted (PGP/MIME or S/MIME)

is_searchableboolean required

Whether message is searchable

is_expiredboolean required

Whether message is expired

has_attachmentboolean required

Whether message has attachments

retention_datestring date-time nullable required

Message retention date

internal_datestring date-time required

Internal date (IMAP)

header_datestring date-time required

Date from message headers

subjectstring required

Message subject

flagsstring[] required

IMAP flags

labelsstring[] required

User-defined labels (lowercase, max 10)

sizeinteger required

Message size in bytes

uidinteger required

IMAP UID

modseqinteger required

Modification sequence

transactionstring required

Transaction type

remote_addressstring required

Remote IP address

created_atstring date-time required

Message creation timestamp

updated_atstring date-time required

Message last update timestamp

nodemailerobject

Parsed message object (included by default, set ?nodemailer=false to exclude)

rawstring

Raw message content (included by default, set ?raw=false to exclude)

object'message' required

Example response

{
  "id": "message123",
  "root_id": "root123",
  "folder_id": "folder123",
  "folder_path": "INBOX",
  "thread_id": "thread123",
  "header_message_id": "<message123@example.com>",
  "is_unread": true,
  "is_flagged": false,
  "is_deleted": false,
  "is_draft": false,
  "is_junk": false,
  "is_copied": false,
  "is_encrypted": false,
  "is_searchable": true,
  "is_expired": false,
  "has_attachment": false,
  "retention_date": null,
  "internal_date": "2025-01-01T00:00:00.000Z",
  "header_date": "2025-01-01T00:00:00.000Z",
  "subject": "Test Message",
  "flags": [
    "\\Seen"
  ],
  "size": 1024,
  "uid": 1,
  "modseq": 1,
  "transaction": "API",
  "remote_address": "127.0.0.1",
  "created_at": "2025-01-01T00:00:00.000Z",
  "updated_at": "2025-01-01T00:00:00.000Z",
  "object": "message"
}

Changes

No recorded changes to this operation across all 1 revision of this API.