Skip to content

append_header

message:append_header(NAME, VALUE)

Constructs a header from NAME: VALUE and appends it to the header portion of the message.

The VALUE is taken as-is and used as the header value.

Since: Dev Builds Only

The functionality described in this section requires a dev build of KumoMTA. You can obtain a dev build by following the instructions in the Installation section.

This method now accepts an additional optional ENCODE parameter, which should be a boolean value:

message:append_header(NAME, VALUE, ENCODE)

When ENCODE is set to true then the VALUE will be encoded:

  • 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.