---
title: "Start or resume a real send-and-receive proof for a starter address."
method: POST
path: "/v1/workspaces/{workspaceId}/onboarding/starter-proof"
---

# Start or resume a real send-and-receive proof for a starter address.

`POST /v1/workspaces/{workspaceId}/onboarding/starter-proof`

## Request

- Base URL: `https://api.bangermail.com`
- URL: `https://api.bangermail.com/v1/workspaces/{workspaceId}/onboarding/starter-proof`
- Auth: HTTP bearer

## Request body

- object
  - `mailbox_id` string, uuid, required

## Response `200`

The existing proof was 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 proof was queued.

---

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