prepend

headers:prepend(NAME, VALUE)

Since: Version 2025.10.06-5ec871ab

The functionality described in this section requires version 2025.10.06-5ec871ab of KumoMTA, or a more recent version.

Constructs a new header with NAME and VALUE and prepends it to the header map.

If the header value is ascii then it will be soft wrapped at whitespace around 75 columns, and hard-wrapped regardless of whitespace at 900 columns.

If the header value is non-ascii then it will be quoted printable encoded using RFC 2047 header encoding.

headers:prepend('X-Something', 'Some value')