Skip to content


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 overrides the next delivery time for the message. The due parameter may be:

  • nil - to indicate that delivery should be attempted as soon as possible.
  • an ISO 8601 date and timestamp to specify the time of the next delivery attempt. msg:set_due("2024-03-08T17:51:42.481711Z")

Setting the due time is only valid in certain limited circumstances:


Using this method in any other way can result in non-deterministic, undefined and unsupported behavior.