feat(mailbox): doc creation MTA-6964

macros/mailbox/add-email-accounts.mdx

@@ -0,0 +1,14 @@
+---
+macro: add-email-accounts
+---
+
+The email account creation window is displayed during the creation of a Mailbox domain or when clicking **Add email account** from a Mailbox domain.
+
+1. Create your email accounts:
+    1. Enter the email prefix.
+    2. Enter a password or click the magic wand button to autogenerate a strong password.
+    3. Enter an email address for password recovery (optional).
+    4. Enter a display name for this account (optional).
+    5. Click **Create**.
+2. If needed, click **Add another email account** and repeat the previous steps.
+3. Check the estimated cost summary, then click **Create email account(s)**.

menu/navigation.ts

@@ -40,6 +40,7 @@ import { keyManagerMenu } from '../pages/key-manager/menu'
 import { kubernetesMenu } from "../pages/kubernetes/menu"
 import { loadBalancerMenu } from "../pages/load-balancer/menu"
 import { localStorageMenu } from "../pages/local-storage/menu"
+import { mailboxMenu } from "../pages/mailbox/menu"
 import { managedDatabasesForPostgresqlAndMysqlMenu } from "../pages/managed-databases-for-postgresql-and-mysql/menu"
 import { managedDatabasesForRedisMenu } from "../pages/managed-databases-for-redis/menu"
 import { managedInferenceMenu } from "../pages/managed-inference/menu"
@@ -176,6 +177,7 @@ export default [
         icon: 'DomainsAndWebHostingCategoryIcon',
         items: [
           domainsAndDnsMenu,
+          mailboxMenu,
           transactionalEmailMenu,
           webhostingMenu,
         ],

pages/mailbox/api-cli/index.mdx

@@ -0,0 +1,4 @@
+---
+title: Mailbox - API/CLI Documentation
+description: Mailbox API/CLI Documentation
+---

pages/mailbox/concepts.mdx

@@ -0,0 +1,107 @@
+---
+title: Mailbox - Concepts
+description: Learn the fundamental concepts of Scaleway Mailbox.
+tags: mailbox
+dates:
+  validation: 2026-03-06
+---
+
+<Message type="note">
+  Mailbox is currently in Public Beta.
+</Message>
+
+## Calendar (CalDAV)
+Mailbox includes a CalDAV server which features synchronization of multiple calendars, integration with compatible clients, and management for multiple devices.
+
+## Contacts (CardDAV)
+Mailbox includes a CardDAV server which features synchronization of contacts, centralized access to mobile and desktop support.
+
+## DNS
+
+**D**omain **N**ame **S**ystem is a name management system for computing devices connected to a network, be it public (internet) or private. It translates text-based [domain names](#domain-name) to numerical IP addresses or other services such as emails.
+
+## DNS propagation
+
+DNS propagation is the time a DNS change takes to be updated across the internet. Mailbox will always find the most recent DNS records to avoid being delayed by DNS caching.
+
+## DNS verification
+
+DNS verification is a mandatory step to validate your domain ownership.
+
+## DNS zone
+
+A DNS zone hosts the DNS records for a distinct part of the global domain namespace and is managed by a specific organization or administrator. For example with Scaleway Domains and DNS, if you are managing the external domain `example.com` with us, this is your root zone. You can [create further zones and subdomains](/domains-and-dns/how-to/configure-dns-zones/), e.g. `mysubdomain.example.com`.
+
+## Domain name
+
+A **domain name** or **domain** is a unique alphanumeric name used to identify a computer (web or email server) on the internet. It translates the numeric address of the computer to a more legible human-readable and memorable name. A domain can consist of a single [DNS Zone](#dns-zone) or be divided into several zones.
+
+## Domain status
+
+|     Status name      |                                                    Description                                                     |
+| -------------------- | ------------------------------------------------------------------------------------------------------------------ |
+| `creating`           | The domain was just registered, but the validation records are not yet available.                                  |
+| `deleted`            | The domain is deleted.                                                                                             |
+| `deleting`           | The domain is in the process of being deleted.                                                                     |
+| `provisioning`       | The domain is validated and in the process of being provisioned.                                                   |
+| `ready`              | The domain is ready to be used and accept mailbox creations.                                                       |
+| `validating`         | The domain is in the process of validation.                                                                        |
+| `validation_failed`  | The domain failed the validation process.                                                                          |
+| `waiting_validation` | The domain is registered but not yet validated.                                                                    |
+
+## Mailbox status
+
+|     Status name      |                                                     Description                                                      |
+| -------------------- | -------------------------------------------------------------------------------------------------------------------- |
+| `creating`           | The mailbox is being created.                                                                                        |
+| `deleting`           | The mailbox is in the process of being deleted.                                                                      |
+| `deletion_scheduled` | The mailbox is planned to be deleted.                                                                                |
+| `locked`             | The mailbox is locked (e.g. billing issue).                                                                          |
+| `ready`              | The mailbox is ready to be used.                                                                                     |
+| `renewing`           | The mailbox is renewing the payment for a new period.                                                                |
+| `restoring`          | The mailbox is being restored after solving a `locked` or `deletion_scheduled` status.                               |
+| `waiting_domain`     | The mailbox is waiting for the domain to be properly configured.                                                     |
+| `waiting_payment`    | The mailbox is waiting for payment.                                                                                  |
+
+## Hard bounce
+
+Hard bounce occurs when an email is sent to an invalid email address or an address that does not exist. Unlike [soft bounce](#soft-bounce), which is a temporary error, hard bounce is a permanent error.
+
+In this case, most emailing solutions will blacklist these email addresses.
+
+## Mailbox
+
+Scaleway Mailbox is an email service associated with a domain. Mailbox main features are:
+- Send and receive emails
+- Access SMTP / IMAP / JMAP / POP3
+- Access a Webmail interface
+- Manage calendars (CalDAV) and contacts (CardDAV)
+
+Each mailbox is composed of:
+- A full email address
+- A password
+- 20 GB of storage
+- An active subscription (per month or per year)
+
+## Protocols
+
+Mailbox supports the following protocols:
+
+|          Usage           |         Protocol          |
+| ------------------------ | ------------------------- |
+| Receiving emails         | IMAP, JMAP, POP3          |
+| Sending emails           | SMTP                      |
+| Calendar synchronization | CalDAV                    |
+| Contact synchronization  | CardDAV                   |
+| Automatic configuration  | Autodiscover / Autoconfig |
+| Simple consultation      | Webmail                   |
+
+## Soft bounce
+
+Soft bounce occurs when your email has been sent to a valid email address and has reached the recipient's mail server, but your email could not be delivered for multiple reasons:
+
+- The recipient's mailbox has exceeded its storage limit
+- The recipient's mail server is down
+- The message was too large for the recipient's mailbox
+
+When a soft bounce occurs, the email software will try to resend the email for 72 hours (maximum) until the message is finally delivered.

pages/mailbox/how-to/configure-mailbox.mdx

@@ -0,0 +1,78 @@
+---
+title: How to configure a Mailbox
+description: This page explains how to configure a Mailbox domain on the Scaleway console.
+tags: mailbox domain mailbox-domain add email dns-records
+dates:
+  validation: 2026-03-09
+  posted: 2026-03-09
+---
+import Requirements from '@macros/iam/requirements.mdx'
+import AddEmailAccounts from '@macros/mailbox/add-email-accounts.mdx'
+
+<Requirements />
+
+- A Scaleway account logged into the [console](https://console.scaleway.com)
+- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
+- [Created your Mailbox domain](/mailbox/how-to/create-mailbox-domain/) 
+
+1. Click **Mailbox** in the **Domains & Web Hosting** section of the [console](https://console.scaleway.com/) side menu. The list of your domains displays.
+2. Click a Mailbox domain to configure.
+
+## Add email accounts
+
+<AddEmailAccounts />
+
+## Access Webmail
+
+In the **Email accounts** tab, click **[Access Webmail](https://mailbox.scw.eu/)** to open the email service application in a new browser tab.
+
+## Check Mailbox DNS Records
+
+<Message type="tip">
+  When you use a domain name registered with [Scaleway Domains and DNS](/domains-and-dns/), you can benefit from DNS autoconfiguration.
+</Message>
+
+1. In the **DNS Records** tab, check and copy information related to email delivery, email authentication, mail client configuration, calendar, and contacts services.
+2. Add the DNS records to your domain management service. 
+3. Click **Check status** to run a validation for all DNS records.
+
+The DNS records are detailed in the following sections.
+
+### Required DNS records
+
+|      Record       |                                          Description                                           |
+| :---------------- | :--------------------------------------------------------------------------------------------- |
+| Domain validation | Verifies that you own the domain before activating Mailbox.                                    |
+| MX                | Defines the mail servers responsible for receiving emails for your domain.                     |
+| DMARC             | Defines how receiving servers should handle emails that fail SPF or DKIM authentication.       |
+| SPF               | Authorizes Mailbox servers to send emails on behalf of your domain and helps prevent spoofing. |
+| DKIM              | Enables cryptographic signing of outgoing emails to improve authenticity and deliverability.   |
+
+### Recommended DNS records
+
+These records improve the automatic configuration of email clients.
+
+|    Record    |                                     Description                                     |
+| :----------- | :---------------------------------------------------------------------------------- |
+| Autoconfig   | Allows email clients to automatically detect the email server configuration.        |
+| Autodiscover | Used by clients such as Microsoft Outlook for automatic email configuration.        |
+| IMAP         | Service discovery record indicating the IMAP server used to retrieve emails.        |
+| JMAP         | Service discovery record indicating the JMAP endpoint used by modern email clients. |
+| POP3         | Service discovery record indicating the POP3 server used to retrieve emails.        |
+| Submission   | Defines the SMTP submission server used to send emails.                             |
+
+### Optional DNS records
+
+These records allow automatic discovery for calendar and contacts synchronization services.
+
+| Record  |                                Description                                |
+| :------ | :------------------------------------------------------------------------ |
+| CalDAV  | Enables automatic configuration of calendar synchronization using CalDAV. |
+| CardDAV | Enables automatic configuration of contact synchronization using CardDAV. |
+
+## Check email account incoming and outgoing protocols
+
+1. Click **Mailbox** in the **Domains & Web Hosting** section of the [console](https://console.scaleway.com/) side menu. The list of your domains displays.
+2. Click a Mailbox domain to configure. The list of Mailboxes created for this domain is displayed.
+3. Click an email account to configure. The email account information is displayed.
+4. In the **Settings** tab, check and copy information related to email delivery (IMAP, PP3 and SMTP).

pages/mailbox/how-to/create-mailbox-domain.mdx

@@ -0,0 +1,46 @@
+---
+title: How to create a Mailbox domain
+description: This page explains how to create a Mailbox domain on the Scaleway console.
+tags: mailbox domain mailbox-domain
+dates:
+  posted: 2026-03-09
+---
+import Requirements from '@macros/iam/requirements.mdx'
+import AddEmailAccounts from '@macros/mailbox/add-email-accounts.mdx'
+
+<Requirements />
+
+- A Scaleway account logged into the [console](https://console.scaleway.com)
+- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
+
+## Add a Mailbox domain
+
+1. Click **Mailbox** in the **Domains & Web Hosting** section of the [console](https://console.scaleway.com/) side menu. The list of your domains displays.
+2. Click **Add new email account**. The Mailbox creation wizard displays.
+3. Select whether to **Use a Scaleway domain** or **Add a domain external to Scaleway**. Follow the next steps according to your choice.
+    <Tabs>
+      <TabsTab label="Scaleway domain">
+      <Message type="tip">
+        When you use a domain name registered with [Scaleway Domains and DNS](/domains-and-dns/), you can benefit from DNS autoconfiguration.
+      </Message>
+        1. Choose your existing Scaleway domain from the drop-down list.
+      </TabsTab>
+      <TabsTab label="External domain">
+        1. Select **Domain registered with an external provider**.
+        2. Enter the domain name you want to use for your Mailbox email accounts.
+      </TabsTab>
+    </Tabs>
+4. Select the subscription plan.
+5. Check the estimated cost summary, then click **Continue to setup**. The email account creation window is displayed.
+
+## Add email accounts
+
+<AddEmailAccounts />
+
+## Domain and Mailbox status
+
+Refer to the [concepts page](/mailbox/concepts/#domain-status) for more information on statuses.
+
+## Access Webmail
+
+In the **Email accounts** tab, click **[Access Webmail](https://mailbox.scw.eu/)** to open the email service application in a new browser tab.

pages/mailbox/how-to/delete-email-account.mdx

@@ -0,0 +1,29 @@
+---
+title: How to delete your Mailbox email account
+description: This page explains how to delete a Mailbox email account on the Scaleway console.
+tags: mailbox delete
+dates:
+  validation: 2026-03-19
+  posted: 2026-03-19
+---
+import Requirements from '@macros/iam/requirements.mdx'
+
+<Requirements />
+
+- A Scaleway account logged into the [console](https://console.scaleway.com)
+- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
+- [Configured your Mailbox domain](/mailbox/how-to/configure-mailbox/) with email accounts.
+
+## How to delete a Mailbox email account
+
+<Message type="important">
+  This action will permanently delete an email account.
+</Message>
+
+1. Click **Mailbox** in the **Domains & Web Hosting** section of the [console](https://console.scaleway.com/) side menu. The list of your domains displays.
+2. Click the domain you wish to configure. The list of Mailboxes created for this domain displays.
+3. Click a Mailbox email account to configure. The Mailbox account information is displayed.
+4. Navigate to the **Settings** tab.
+5. Click **Delete email account**.
+6. Type **DELETE** to confirm.
+7. Click **Delete email account**.

pages/mailbox/how-to/delete-mailbox-domain.mdx

@@ -0,0 +1,31 @@
+---
+title: How to delete your Mailbox domain
+description: This page explains how to delete a Mailbox domain on the Scaleway console.
+tags: mailbox domain delete mailbox-domain
+dates:
+  validation: 2026-03-19
+  posted: 2026-03-19
+---
+import Requirements from '@macros/iam/requirements.mdx'
+
+
+<Requirements />
+
+- A Scaleway account logged into the [console](https://console.scaleway.com)
+- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
+- [Configured your Mailbox domain](/mailbox/how-to/configure-mailbox/)
+
+## How to delete a Mailbox domain
+
+<Message type="important">
+  This action will permanently delete your domain and all associated email accounts. When a Mailbox domain is deleted, emails cannot be sent or received.
+</Message>
+
+1. Click **Mailbox** in the **Domains & Web Hosting** section of the [console](https://console.scaleway.com/) side menu. The list of your domains displays.
+2. Click the domain you wish to delete. The overview of your domain displays.
+4. Navigate to the **Settings** tab.
+3. Click **Delete domain**.
+4. Type **DELETE** to confirm.
+5. Click **Delete domain**.
+
+

pages/mailbox/how-to/index.mdx

@@ -0,0 +1,4 @@
+---
+title: Mailbox - How Tos
+description: Practical guides for using Scaleway Mailbox.
+---