---
title: "Create Mailboxes V2"
method: POST
path: "/v2/mailboxes"
tags: ["Mailboxes"]
---

# Create Mailboxes V2

`POST /v2/mailboxes`

## Request

- Base URL: `https://public.outreach2day.com`
- URL: `https://public.outreach2day.com/v2/mailboxes`
- Auth: HTTP bearer

Save local mailbox records without claiming provider setup or completion.

## Query parameters

- `workspaceId` integer, required

## Request body

- CreateMailboxRequest[]
  - `first_name` string, required
  - `last_name` string, required
  - `address` string, required
  - `domain_id` integer, required
  - `password` string, required

## Response `200`

Successful Response

- PublicMailboxAdmissionV2Out
  - `status` 'accepted', required
  - `outcome` 'local_records_saved', required
  - `workspaceId` integer, required
  - `requestedCount` integer, required
  - `acceptedCount` integer, required
  - `providerSetup` PublicMailboxProviderSetupV2Out, required
    - `state` 'not_scheduled', required
  - `operationId` unknown, required
  - `statusUrl` unknown, required
  - `message` 'Mailbox local records saved; provider setup not scheduled', required
  - `next_action` 'create_quote': Provider setup is not scheduled by this call; mailboxes are created automatically after an order is paid.
  - `next_step` string, required
  - `links` object, required

## Other responses

- `402`: Payment required. Create a quote (POST /v2/quotes), show it to the human and let them pay on the Stripe page; nothing was charged.
- `422`: Validation Error

---

[API](https://skmtc.dev/outreach2day/apis/outreach-today-public-api.md) · [All operations](https://skmtc.dev/outreach2day/apis/outreach-today-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/outreach2day/apis/outreach-today-public-api/revisions/6c02339eef43?raw)