Skip to content

MailerUpdateSendWindow

PUT mailer/sendWindow

Updates a send window. Only the fields present in the request are changed.

countryIso cannot be changed: a window is identified by its country inside the brand. To move a rule to another country, create the new window and delete the old one.

Access Control

Allowed role: admin, within the brand of the caller.

Request

PUT https://{broker_domain}/mailer/sendWindow
{
  "id": 5,
  "allowedTo": "19:00"
}
{
  "command": "MailerUpdateSendWindow",
  "extID": "1",
  "data": {
    "id": 5,
    "allowedTo": "19:00"
  }
}
const res = await platform.MailerUpdateSendWindow({
  id: 5,
  allowedTo: "19:00"
});

Request Data

Field Type Required Description
id int Yes Window id
timezone string No IANA timezone override
allowedFrom string No Window start as HH:mm
allowedTo string No Window end as HH:mm
weekdays array No Allowed weekdays [1..7]
deferOutsideWindow bool No true defers an email outside the window, false rejects it
description string No Free-form note
status enum No ENABLED or DISABLED

Response Data

{
  "id": 5,
  "countryIso": "DE",
  "allowedFrom": "09:00",
  "allowedTo": "19:00",
  "weekdays": [1, 2, 3, 4, 5],
  "deferOutsideWindow": true,
  "status": "ENABLED",
  "updatedAt": "2026-08-24 14:41:33"
}

Errors

Code Error Description
400 VALIDATION_ERROR Time is not HH:mm, or a weekday is outside 1..7
404 NOT_FOUND Window not found in the brand