---
title: "Create Proposal"
method: POST
path: "/api/v1/admin/orders/{order_id}/proposals"
tags: ["Admin Orders"]
---

# Create Proposal

`POST /api/v1/admin/orders/{order_id}/proposals`

## Request

- Base URL: `https://api.g3m.co` (the document declares no server; this is the origin it was published from)
- URL: `https://api.g3m.co/api/v1/admin/orders/{order_id}/proposals`
- Auth: none declared

## Path parameters

- `order_id` string, uuid, required

## Request body

- ProposalCreate
  - `proposal_round` integer
  - `title` string, required
  - `description` string, required
  - `currency` string
  - `items` ProposalItemCreate[], required
    - `title` string, required
    - `description` string, nullable
    - `vendor_name` string, nullable
    - `product_url` string, uri, nullable
    - `image_url` string, uri, nullable
    - `availability_notes` string, nullable
    - `quantity` integer
    - `unit_price_cents` integer, required
    - `sort_order` integer
  - `costs` ProposalCostCreate[]
    - `type` 'product' | 'sourcing_fee' | 'fulfillment_fee' | 'shipping' | 'courier' | 'tax' | 'packaging' | 'other', required
    - `description` string, required
    - `amount_cents` integer, required
    - `sort_order` integer

## Response `201`

Successful Response

- ProposalOut
  - `id` string, uuid, required
  - `order_id` string, uuid, required
  - `proposal_round` integer, required
  - `title` string, required
  - `description` string, required
  - `status` 'draft' | 'proposed' | 'approved' | 'rejected' | 'withdrawn', required
  - `currency` string, required
  - `items_subtotal_cents` integer, required
  - `fees_total_cents` integer, required
  - `total_amount_cents` integer, required
  - `approved_by_user_id` string, uuid, nullable, required
  - `approved_at` string, date-time, nullable, required
  - `created_at` string, date-time, required
  - `items` ProposalItemOut[]
    - `id` string, uuid, required
    - `title` string, required
    - `description` string, nullable, required
    - `vendor_name` string, nullable, required
    - `product_url` string, nullable, required
    - `image_url` string, nullable, required
    - `availability_notes` string, nullable, required
    - `quantity` integer, required
    - `unit_price_cents` integer, required
    - `subtotal_cents` integer, required
    - `sort_order` integer, required
  - `costs` ProposalCostOut[]
    - `id` string, uuid, required
    - `type` 'product' | 'sourcing_fee' | 'fulfillment_fee' | 'shipping' | 'courier' | 'tax' | 'packaging' | 'other', required
    - `description` string, required
    - `amount_cents` integer, required
    - `sort_order` integer, required

## Other responses

- `422`: Validation Error

---

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