---
title: "Idempotently create the permanent hosted mailbox and start its real welcome-message round trip."
method: POST
path: "/v1/workspaces/{workspaceId}/onboarding/agent-state/aha-one"
---

# Idempotently create the permanent hosted mailbox and start its real welcome-message round trip.

`POST /v1/workspaces/{workspaceId}/onboarding/agent-state/aha-one`

## Request

- Base URL: `https://api.bangermail.com`
- URL: `https://api.bangermail.com/v1/workspaces/{workspaceId}/onboarding/agent-state/aha-one`
- Auth: HTTP bearer

## Response `200`

The hosted mailbox and its existing proof were resumed.

- object
  - `data` StarterMailboxProof, required
    - `proof_id` string, uuid, required
    - `mailbox_id` string, uuid, required
    - `mailbox_address` string, email, required
    - `command_id` string, uuid, required
    - `phase` 'sending' | 'sent' | 'received' | 'checked' | 'failed', required
    - `send_complete` boolean, required
    - `receive_complete` boolean, required
    - `round_trip_check_complete` boolean, required
    - `agent_check_complete` boolean, required
    - `complete` boolean, required
    - `expected_subject` string, required
    - `expected_body_text` string, required
    - `received_message_id` string, uuid
    - `received_thread_id` string, uuid
    - `received_subject` string
    - `received_body_text` string
    - `received_at` string, date-time
    - `agent_label` string
    - `agent_suggested_action` string
    - `error_code` string
    - `replayed` boolean, required

## Other responses

- `202`: The hosted mailbox exists and its real proof is running or already complete.

---

[API](https://skmtc.dev/bangermail/apis/banger-api.md) · [All operations](https://skmtc.dev/bangermail/apis/banger-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bangermail/apis/banger-api/revisions/a149909267f9?raw)