---
title: "Create a proposal"
method: POST
path: "/api/v2/proposals"
tags: ["Proposals"]
---

# Create a proposal

`POST /api/v2/proposals`

Create a new proposal.

## Headers

- `X-Organization-Id` string, required

## Response `201`

Single proposal

## Changes

- **2026-09-02** `061c271b2e3a` — 2 warning, 1 info
  - removed the optional property `data/attributes/audit_pdf_url` from the response with the `201` status
  - removed the optional property `data/attributes/original_pdf_url` from the response with the `201` status
  - added the optional property `data/attributes/number` to the response with the `201` status

[Change history](https://skmtc.dev/productive/apis/api-documentation/changes/api/v2/proposals/post.md)

---

[API](https://skmtc.dev/productive/apis/api-documentation.md) · [All operations](https://skmtc.dev/productive/apis/api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/productive/api-documentation/revisions/061c271b2e3a/schema)