---
title: "Mark a prepared engagement request as sent by the customer (#2560)"
method: POST
path: "/onboarding/v3/prepared-profile/requests/{requestId}/submit"
tags: ["Onboarding"]
---

# Mark a prepared engagement request as sent by the customer (#2560)

`POST /onboarding/v3/prepared-profile/requests/{requestId}/submit`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/onboarding/v3/prepared-profile/requests/{requestId}/submit`
- Auth: HTTP bearer

Customer-controlled state only. Accountant verification, task selection, price and verified access are never writable from this endpoint.

## Headers

- `X-Median-App-Surface` 'qa'

## Request body

- object
  - `note` string

## Response `200`

Updated prepared engagement view

- object
  - `success` true, required
  - `data` PreparedOnboardingProfileView, required: Customer-facing, read-only view of a prepared engagement (#2560).
    - `taskIds` string[], required
    - `engagement` object, required
      - `ledger` 'median' | 'quickbooks' | 'xero', required
      - `serviceStartLabel` string, required
      - `closeTargetLabel` string, required
      - `summary` string
      - `monthlyPriceCents` integer, nullable, required
      - `trialDays` integer, nullable, required
      - `billingInterval` 'month' | 'year' | 'null', nullable: Paid subscription's interval, else the offer's.
      - `chargedAmountCents` integer, nullable: Amount charged per billing interval (an annual plan's full charge).
      - `termStart` string, date, nullable: First day of the paid period (America/New_York); null before payment.
      - `termEnd` string, date, nullable: Last day of the paid period; null before payment.
    - `companyFacts` object, required
      - `legalName` string, required
      - `qboCompanyName` string
    - `verifiedAccess` PreparedOnboardingVerifiedAccess[], required
      - `kind` 'qbo_accountant_access' | 'bank_portal_view' | 'payroll_portal_view' | 'other', required
      - `source` string, required
      - `verifiedOn` string, required
      - `note` string
    - `requests` object[], required
      - `id` string, required
      - `label` string, required
      - `detail` string
      - `channel` 'secure_upload' | 'forwarding' | 'share', required
      - `status` 'open' | 'submitted' | 'verified', required
      - `submittedAt` string, date-time, nullable, required
      - `verifiedAt` string, date-time, nullable, required
    - `stripe` object, required
      - `expectation` 'connect' | 'none', required

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member
- `404`: Resource not found
- `422`: Validation error

---

[API](https://skmtc.dev/medianfi/apis/median-api.md) · [All operations](https://skmtc.dev/medianfi/apis/median-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medianfi/apis/median-api/revisions/20090ea32b0d?raw)