---
title: "POST /v1/workspaces/{workspaceId}/sending-lanes/plan"
method: POST
path: "/v1/workspaces/{workspaceId}/sending-lanes/plan"
---

# POST /v1/workspaces/{workspaceId}/sending-lanes/plan

`POST /v1/workspaces/{workspaceId}/sending-lanes/plan`

## Request

- Base URL: `https://api.bangermail.com`
- URL: `https://api.bangermail.com/v1/workspaces/{workspaceId}/sending-lanes/plan`
- Auth: HTTP bearer

Read-only availability and DNS preflight. It creates no resources. Website records alone do not occupy an email hostname. Returns existing setup and conflicts at names Banger must change. Existing sending authentication and DMARC policies are preserved.

## Request body

- EmailLaneInput
  - `domain` string, required: Parent company domain, such as example.com.
  - `from_domain` string, required: Exact root or subdomain to configure, such as example.com or news.example.com.
  - `lane` 'mailbox' | 'product' | 'broadcast', required: Mail is mailbox. It sends and receives; Product and Broadcast are optional dedicated sending lanes.
  - `root_dmarc_confirmed` boolean: Legacy compatibility field; setup preserves existing email policies and requires no confirmation.
  - `route_providers` object
    - `product` 'banger' | 'resend'
    - `broadcast` 'banger' | 'resend'
  - `route_domains` object
    - `product` string
    - `broadcast` string

## Response `200`

Lane setup plan.

- object
  - `data` EmailLanePlan, required
    - `status` 'available' | 'existing' | 'occupied' | 'migration_required', required
    - `from_domain` string, required
    - `lane` 'mailbox' | 'product' | 'broadcast', required
    - `domain_id` string, nullable, required
    - `lane_id` string, nullable, required
    - `message` string, required
    - `requires_root_confirmation` boolean, required: Always false; existing email policies are preserved.
    - `existing_dns` object[], required
      - `name` string, required
      - `type` string, required
      - `value` string, required

---

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