---
title: "Reserve (create/own) a private email address"
method: POST
path: "/addresses/{email}"
tags: ["Addresses"]
---

# Reserve (create/own) a private email address

`POST /addresses/{email}`

Sets the email address private and "owned" by the account. All messages which already exist,
and any future messages which are received, will be private to this account only.

An email address must be reserved to be able to forward messages to another email address,
Slack, web sockets, or webhooks. Public email addresses, and private email addresses under
a custom domain, are not routeable.

## Request body

- UpdatePrivateAddressForwarding — body object to update address forwarding
  - `info` string — User configurable metadata about this enhanced private address.
  - `forward` string — email address - SMTP forwarding / standard email forwarding - set to "" or null to disable forwarding
  - `enablews` boolean — boolean, defaults false - set to true to enable web socket forwarding (see Web Socket API)
  - `webhook` string — url - set to your public webhook endpoint to receive mail via webhook - set to "" or null to disable webhooks
  - `webhookSlack` string — Slack webhook URL where messages will be published.
  - `webhookSlackToFrom` boolean — When webhookSlack is set, controls whether the message includes TO and FROM

## Response `200`

Returns the newly created email address

- EmailAddress
  - `_id` string, email — the unique identifier of this email address is the email address itself
  - `info` string — Allows setting custom information about this email address.
  - `enabledws` boolean — boolean defaulting false indicating whether to publish messages via web socket when the user owning this inbox is subscribed
  - `forward` string, email — email address where messages to this inbox will be forwarded
  - `webhook` string, url — URL where messages to this inbox will be forwarded
  - `webhookSlack` string, url — Slack webhook endpoint where messages should be published
  - `webhookSlackToFrom` boolean — When webhookSlack is set, controls whether the message includes TO and FROM
  - `owner` string — Account that owns the address (owns the privacy)
  - `encryptedInbox` string, email — An alternate email address that will result in the message being delivered to this inbox. This is not always present.
  - `catchAll` string, domain — Indicates whether this is a catch-all address, and for which domain.
  - `implicit` boolean — When the user owns the domain but has not reserved the address individually, this field is set to true.
  - `created` string, date-time
  - `updated` string, date-time

## Other responses

- `400` — Already reserved by the current user
- `401` — Owned by another account

---

[API](https://skmtc.dev/mailsac/apis/mailsac-api-specification.md) · [All operations](https://skmtc.dev/mailsac/apis/mailsac-api-specification/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mailsac/mailsac-api-specification/revisions/5f8b55c76229/schema)