Skip to content

Mailbox.warm

Ramps a new Mailbox from 5 sends a day to 25 over 14 days, before any cold email leaves it.

Action class
None
Approval
Runs on its own
Emits
Mailbox.warmed
Price
Free
POST https://api.sb/{your-domain}/mailboxes/{mailbox}/warm

Its Inputs, Outputs, Effects and guards quote the hub’s Mailbox.warm; this page adds what each Venue honors, its limits and a worked call. It is one of the Verbs of Mailboxes.

Inputs

NameTypeDefaultMeaning
mailboxMailboxRequiredThe new Mailbox.
capintegerRequiredThe daily sends it ramps to.

Outputs

FieldTypeWhat null means
mailboxMailboxNever null: the Mailbox, warming.

Effects

Action class

None: no approval rule names it, so it runs within its seat’s Permissions and Limits

Modes
  • try: Runs every check and returns the record as it would be; nothing is stored.
  • send: Returns a pending Action at once; Mailbox.warmed fires when it is done.
  • do: Waits for the Action to finish and returns the record.
Idempotency

Only with a key: the same Idempotency-Key and input return the first Action, and the same key with other input returns 409.

Saved or shared

Raises the daily cap on a schedule while the spam rate stays under 0.1 percent.

Emits

Mailbox.warmed with { mailbox }

Performed by

Customer lead

Price

Free on your own account: the platform charges nothing for the call.

Limits

Fourteen days from 5 sends a day to 25; no cold email leaves a Mailbox still warming.

On each Venue

It acts on your own records and reaches no Venue, so every account answers the same way.

What try does

Runs every check the call meets and returns the record as it would be; nothing is stored, sent or posted.

Refuses when

The hub sets no guard of its own on this call: it refuses only on the shared checks every write meets (a missing record, a Permission the seat lacks).

When it waits

Returns in one response; nothing waits.

Example

In send mode the call returns its pending Action at once, and Mailbox.warmed delivers the result.

You, to your agent
Warm up dana@tryleaseline.app to 25 sends a day before any cold email
leaves it.
Response, in send mode
{
  "mode": "send",
  "action": {
    "$id": "https://api.sb/leaseline.app/actions/action_Sd3kQ9vT2w",
    "operation": "Mailbox.warm",
    "status": "pending",
    "reason": "running"
  }
}

To retry, send the same Idempotency-Key: the retry returns the first answer for $0. A new key reads again.

Used by