Warmy icon

Warmy

Manage Warmy.io mailboxes and warmup settings

Mailbox → Update

AI-generated

Summary

Update a Warmy mailbox's warmup settings (speed or detailed ramp-up, daily limit, reply rate) and optionally its sender display name via a PUT to /api/v2/mailboxes/{id}.

Inputs

  • mailboxId (required) — Mailbox to update, chosen from a searchable list or entered by ID.
  • settingMode (required) — Must match the workspace's settings_form_mode: Speed Form, Detail Default, or Detail Custom. Controls which fields are sent.
  • updateSpeedMode — Slow, Medium or Fast. Only used in Speed Form mode, where it is always sent (default medium).
  • updateStartOnDayOne — Emails to send on day one. Used in the Detail modes and sent only if non-zero.
  • updateIncreasePerDay — Daily increase in sending volume. Used in the Detail modes and sent only if non-zero.
  • updateUserMaxLimit — Maximum daily email limit. Sent only if non-zero.
  • updateReplyRate — Reply rate percentage (should not exceed 35). Sent only if non-zero.
  • updateAdditionalFields — Optional collection. From Name sets the sender display name. Settings ID is the ID of the mailbox setting record to update.

Output shape

One item per input item, containing the JSON response from the Warmy API for the updated mailbox.

Zero or empty values are omitted from the request, so you can't set a value to 0 with this operation. In the Detail modes, setting_mode is sent along with the values. If Continue On Fail is enabled, a failed item returns {error: message} instead.

Examples

Example 1: Switch a mailbox to faster warmup in a workspace using speed mode

Mailbox: pick from list; Setting Mode: Speed Form; Speed Mode: Fast; leave other fields at defaults.

Example 2: Set a custom ramp-up and rename the sender

Setting Mode: Detail Custom; Start on Day One: 5; Increase per Day: 2; User Max Limit: 40; Reply Rate: 30; Update Fields > From Name: 'Jane from Acme'.

Links

Discussion