Out of office
Out of office answers incoming email with an automatic reply. Use it for a vacation, or any time you want senders to know you are away. The API calls this setting auto-reply.
Last updated
How it works
When out of office is on for a mailbox, an eligible inbound email receives the configured reply. The mail server sends it, so the reply goes out right away and you make no API calls.
Each sender gets at most one reply every 7 days, so a long thread doesn't fill their inbox with copies.
Turning on out of office replies
- Go to the Mailboxes page.
- Click the mailbox you want to configure. The mailbox settings page opens.
- In the Incoming mail section, click Out of office.
- Toggle it on and write your message. You can also set start and end dates.
- Click Save. The mailbox row shows an OOO badge.
Date scheduling
Start and end dates are optional. With both set, the reply runs only between them, and the mailbox works as usual the rest of the time. With no dates, the reply runs until you turn it off. Once the end date passes, the mailbox row shows an OOO expired badge.
Example messages
Need help with the wording? The auto-reply email examples guide has copy-ready messages for a customer acknowledgement, out of office and leave, a delayed response, an unmonitored mailbox, a former employee, and a support queue, plus the limits to check before you turn one on.
To fill in your own name, return date and backup contact, use the out of office message generator. It writes plain text, ready to paste here.
API
Use the PATCH /v1/mailboxes/:id/auto-reply endpoint to set out of office from code. See the Mailboxes API reference for details.
curl -X PATCH https://shipmail.to/api/v1/mailboxes/f47ac10b-58cc-4372-a567-0e02b2c3d479/auto-reply \
-H "Authorization: Bearer sm_live_..." \
-H "Content-Type: application/json" \
-d '{
"enabled": true,
"body": "I am away until January 6. I will reply when I return.",
"from_date": "2026-12-23T00:00:00Z",
"to_date": "2027-01-06T00:00:00Z"
}'Turning out of office off
Toggle it off in the dashboard, or send a PATCH request with {"enabled": false}. This clears the saved message and dates.
Limitations
- The message is plain text only. No HTML.
- The message can be up to 5,000 characters.
- Each sender gets at most one reply every 7 days per mailbox.
- Out of office belongs to the mailbox, not to a person. While it is on, delivery routing skips that mailbox for new conversations, unless it is the designated fallback. Existing conversations stay in the same mailbox.
- A suspended mailbox sends no replies. Its settings come back when the mailbox is unsuspended.