---
title: "Create email bomb"
method: POST
path: "/v0/messages/bombs"
tags: ["Email Bombs"]
---

# Create email bomb

`POST /v0/messages/bombs`

Mark a mailbox time range as an email bomb. A new bomb is created if no existing bomb covers the range; otherwise the existing bomb is extended. Messages within the range are associated asynchronously.

## Request body

- CreateEmailBombInput
  - `end_time` string, date-time, required — End of the email bomb time range (must not be in the future)
  - `mailbox_id` string, required — ID of the mailbox to declare the email bomb for
  - `start_time` string, date-time, required — Start of the email bomb time range

## Response `202`

Accepted

- HandlersV0CreateEmailBombResponse
  - `created_bomb_id` string, uuid, nullable — ID of the newly created bomb. Omitted when the time range merged into existing bombs.
  - `overlapping_bomb_ids` string[] — IDs of all bombs overlapping the requested time range
  - `updated_bomb_ids` string[] — IDs of existing bombs expanded to cover the requested time range

---

[API](https://skmtc.net/sublime/apis/sublime-platform-api.md) · [All operations](https://skmtc.net/sublime/apis/sublime-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sublime/sublime-platform-api/versions/d5df82850357/schema)