# openemail.mailboxes

A mailbox's mail settings: its usage, its retention window, its event and message webhooks, what delivers to it, the addresses it may send as and whether it…

A mailbox's mail settings: its usage, its retention window, its event and message webhooks, what delivers to it, the addresses it may send as and whether it may send.

Its 16 methods, each a page of its own, in the order the API reference presents them:

| Method | What it does | It calls |
| --- | --- | --- |
| [`mailboxes.get`](/docs/sdks/typescript/mailboxes/get) | Get mailbox details and usage statistics | [`GET /mailboxes/{mailboxId}`](/docs/api/mailboxes/get_MailboxGet) |
| [`mailboxes.getRetention`](/docs/sdks/typescript/mailboxes/get-retention) | Get retention policy and preview | [`GET /mailboxes/{mailboxId}/retention`](/docs/api/mailboxes/get_RetentionGet) |
| [`mailboxes.setRetention`](/docs/sdks/typescript/mailboxes/set-retention) | Set retention window | [`PUT /mailboxes/{mailboxId}/retention`](/docs/api/mailboxes/put_RetentionPut) |
| [`mailboxes.clearRetention`](/docs/sdks/typescript/mailboxes/clear-retention) | Clear retention window | [`DELETE /mailboxes/{mailboxId}/retention`](/docs/api/mailboxes/delete_RetentionDelete) |
| [`mailboxes.getEventWebhook`](/docs/sdks/typescript/mailboxes/get-event-webhook) | Read the mailbox's event webhook | [`GET /mailboxes/{mailboxId}/event-webhook`](/docs/api/mailboxes/get_MailboxEventWebhookGet) |
| [`mailboxes.setEventWebhook`](/docs/sdks/typescript/mailboxes/set-event-webhook) | Create or replace the mailbox's event webhook | [`PUT /mailboxes/{mailboxId}/event-webhook`](/docs/api/mailboxes/put_MailboxEventWebhookSet) |
| [`mailboxes.deleteEventWebhook`](/docs/sdks/typescript/mailboxes/delete-event-webhook) | Remove the mailbox's event webhook | [`DELETE /mailboxes/{mailboxId}/event-webhook`](/docs/api/mailboxes/delete_MailboxEventWebhookDelete) |
| [`mailboxes.testEventWebhook`](/docs/sdks/typescript/mailboxes/test-event-webhook) | Send a test event to the mailbox's event webhook | [`POST /mailboxes/{mailboxId}/event-webhook/test`](/docs/api/mailboxes/post_MailboxEventWebhookTest) |
| [`mailboxes.getMessageWebhook`](/docs/sdks/typescript/mailboxes/get-message-webhook) | Read the mailbox's message webhook | [`GET /mailboxes/{mailboxId}/message-webhook`](/docs/api/mailboxes/get_MailboxMessageWebhookGet) |
| [`mailboxes.setMessageWebhook`](/docs/sdks/typescript/mailboxes/set-message-webhook) | Create or replace the mailbox's message webhook | [`PUT /mailboxes/{mailboxId}/message-webhook`](/docs/api/mailboxes/put_MailboxMessageWebhookSet) |
| [`mailboxes.deleteMessageWebhook`](/docs/sdks/typescript/mailboxes/delete-message-webhook) | Remove the mailbox's message webhook | [`DELETE /mailboxes/{mailboxId}/message-webhook`](/docs/api/mailboxes/delete_MailboxMessageWebhookDelete) |
| [`mailboxes.getRouting`](/docs/sdks/typescript/mailboxes/get-routing) | List what delivers to a mailbox | [`GET /mailboxes/{mailboxId}/routing`](/docs/api/mailboxes/get_MailboxRoutingGet) |
| [`mailboxes.listSendAs`](/docs/sdks/typescript/mailboxes/list-send-as) | List the addresses a mailbox may send as | [`GET /mailboxes/{mailboxId}/send-as`](/docs/api/mailboxes/get_MailboxSendAsList) |
| [`mailboxes.checkSendAs`](/docs/sdks/typescript/mailboxes/check-send-as) | Check whether a mailbox may send from an address | [`POST /mailboxes/{mailboxId}/send-as/check`](/docs/api/mailboxes/post_MailboxSenderCheck) |
| [`mailboxes.getSendUsage`](/docs/sdks/typescript/mailboxes/get-send-usage) | Get outbound send rate limit usage | [`GET /mailboxes/{mailboxId}/send-usage`](/docs/api/mailboxes/get_SendUsageGet) |
| [`mailboxes.getSendState`](/docs/sdks/typescript/mailboxes/get-send-state) | Get whether a mailbox may send | [`GET /mailboxes/{mailboxId}/send-state`](/docs/api/mailboxes/get_MailboxSendState) |

In the API reference: [Mailboxes](/docs/api/mailboxes).
