---
title: "POST /v1/setup_sending"
method: POST
path: "/v1/setup_sending"
tags: ["GTM verbs"]
---

# POST /v1/setup_sending

`POST /v1/setup_sending`

## Request

- Base URL: `https://api.layrcake.dev`
- URL: `https://api.layrcake.dev/v1/setup_sending`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `emails_per_week` integer, required
  - `prefer_prewarmed` boolean
  - `brand_hint` string
  - `sender` object
    - `first_name` string, required
    - `last_name` string, required
  - `confirmation_token` string
  - `approval_url` string, uri
  - `dry_run` boolean

## Response `200`

Successful outcome

- union
  - object
    - `result` union, required
      - object
        - `status` 'quote' | 'purchased', required
        - `quote` object, required
          - `domains` integer, required
          - `mailboxes` integer, required
          - `setup_credits` string, required
          - `upkeep_credits_per_month` string, required
          - `renewal_cadence` 'monthly', required
          - `cancellation_policy` string, required
          - `ready_estimate` 'immediate' | 'days' | 'weeks', required
          - `quote_expires_at` string, required
        - `card_quote` object
          - `currency` 'usd', required
          - `total_cents` integer, required
          - `domain_one_off_cents` integer, required
          - `mailbox_first_month_cents` integer, required
          - `mailbox_monthly_cents` integer, required
          - `price_version` string, required
          - `total_display` string, required
        - `billing_period` object
          - `start` string, required
          - `end` string, required
        - `confirmation_token` string
        - `approval_url` string, uri
        - `approval_email` 'queued' | 'reused' | 'suppressed_rate_limit' | 'no_approver'
        - `operation_id` string
        - `domains` string[]
      - object
        - `dry_run` true, required
        - `advisory` true, required
        - `evaluated_at` string, required
        - `plan` object, required
          - `verb` 'setup_sending', required
          - `plan_version` 3, required
          - `input_version` string, required
          - `credits_estimate` string, required
          - `would_exceed` string[], required
          - `warnings` string[], required
          - `would` object, required
            - `domains` integer, required
            - `mailboxes` integer, required
            - `setup_credits` string, required
            - `upkeep_credits_per_month` string, required
            - `needs_confirmation` true, required
  - object
    - `result` union, required
      - object
        - `status` 'quote' | 'purchased', required
        - `quote` object, required
          - `domains` integer, required
          - `mailboxes` integer, required
          - `setup_credits` string, required
          - `upkeep_credits_per_month` string, required
          - `renewal_cadence` 'monthly', required
          - `cancellation_policy` string, required
          - `ready_estimate` 'immediate' | 'days' | 'weeks', required
          - `quote_expires_at` string, required
        - `card_quote` object
          - `currency` 'usd', required
          - `total_cents` integer, required
          - `domain_one_off_cents` integer, required
          - `mailbox_first_month_cents` integer, required
          - `mailbox_monthly_cents` integer, required
          - `price_version` string, required
          - `total_display` string, required
        - `billing_period` object
          - `start` string, required
          - `end` string, required
        - `confirmation_token` string
        - `approval_url` string, uri
        - `approval_email` 'queued' | 'reused' | 'suppressed_rate_limit' | 'no_approver'
        - `operation_id` string
        - `domains` string[]
      - object
        - `dry_run` true, required
        - `advisory` true, required
        - `evaluated_at` string, required
        - `plan` object, required
          - `verb` 'setup_sending', required
          - `plan_version` 3, required
          - `input_version` string, required
          - `credits_estimate` string, required
          - `would_exceed` string[], required
          - `warnings` string[], required
          - `would` object, required
            - `domains` integer, required
            - `mailboxes` integer, required
            - `setup_credits` string, required
            - `upkeep_credits_per_month` string, required
            - `needs_confirmation` true, required
    - `layrcake` object, required
      - `request_id` string, uuid, required
      - `credits_charged` string, required
      - `credits_available` string, required
      - `replayed` boolean
      - `route` object
        - `used` 'balanced' | 'cheapest' | 'broadest' | 'fastest', required
        - `source` 'request' | 'key' | 'guess' | 'default', required

## Other responses

- `4XX`: Caller, scope, confirmation, or credit error
- `5XX`: Provider or service error

---

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