---
title: "Reserve multiple enhanced addresses"
method: POST
path: "/private-addresses-bulk"
tags: ["Addresses"]
---

# Reserve multiple enhanced addresses

`POST /private-addresses-bulk`

Reserves multiple enhanced private addresses. The max addresses per request is 100.

It is not necessary to create enhanced addresses before receiving email. Enhanced addresses
are only necessary to forward messages to another email address, Slack, web sockets, webhooks,
or fetch messages over POP3.

## Request body

- object
  - `addresses` EmailString[] — email addresses

## Response `200`

Returns the newly created email addresses

- EmailAddress[] — email addresses
  - `_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` — Not enough enhanced address credits
- `401` — Not authorized. You may need to log in first.

---

[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)