Delete a mailbox

DELETE

/v1/email/mailboxes/{mailbox_id}

await bird.email.mailboxes.delete("mbx_01abc");

client.email.mailboxes.delete("mbx_01krdgeqcxet5s7t44vh8rt9mg")

if err := client.Email.Mailboxes.Delete(context.Background(), "mbx_123"); err != nil {
	log.Fatal(err)
}

$bird->email->mailboxes->delete('mbx_01krdgeqcxet5s7t44vh8rt9mg');

bird email mailboxes delete <mailbox-id> --yes

curl -X DELETE "https://us1.platform.bird.com/v1/email/mailboxes/{mailbox_id}" \
  -H "Authorization: Bearer $TOKEN"

Deletes a mailbox. The address stops receiving mail immediately and enters quarantine. After 30 days, your workspace can bind the address to a new mailbox; the address remains reserved to your workspace. You can restore the mailbox for 30 days with POST /email/mailboxes/{mailbox_id}/restore. Normal message-retention expiry continues during that period. After 30 days, the mailbox and its remaining messages are permanently deleted. Returns 409 (E01028) if an enabled inbound route targets the mailbox. Disable, delete, or redirect those routes before retrying.

Parameters

mailbox_id

string

Mailbox identifier. Starts with mbx_.

Related resources

Continue with the documentation, guides and examples for this topic. Resources are in English.

Watch the guideSetting up your coding agent Understand the conceptWhat is an MCP server, and how does an agent use one to send messages?Explore the capabilityCoding agents Follow the learning pathBuild with AI agents

Get an implementation brief

await bird.email.mailboxes.delete("mbx_01abc");

client.email.mailboxes.delete("mbx_01krdgeqcxet5s7t44vh8rt9mg")

if err := client.Email.Mailboxes.Delete(context.Background(), "mbx_123"); err != nil {
	log.Fatal(err)
}

$bird->email->mailboxes->delete('mbx_01krdgeqcxet5s7t44vh8rt9mg');

bird email mailboxes delete <mailbox-id> --yes

curl -X DELETE "https://us1.platform.bird.com/v1/email/mailboxes/{mailbox_id}" \
  -H "Authorization: Bearer $TOKEN"