---
title: "Creates a new lease."
method: POST
path: "/leases"
---

# Creates a new lease.

`POST /leases`

## Request body

- object
  - `principalId` string, required
  - `budgetAmount` number, required
  - `budgetCurrency` string, required
  - `budgetNotificationEmails` string[], required

## Other responses

- `201` — unresolved $ref
- `403` — Failed to authenticate request

## Changes

- **2019-10-21** `eed5055f8eb6` — 3 warning, 3 info
  - the optional response header `Access-Control-Allow-Headers` removed for the status `201`
  - the optional response header `Access-Control-Allow-Methods` removed for the status `201`
  - the optional response header `Access-Control-Allow-Origin` removed for the status `201`
  - removed the non-success response with the status `400`
  - …2 more

[Change history](https://skmtc.dev/optum/apis/namespace/changes/leases/post.md)

---

[API](https://skmtc.dev/optum/apis/namespace.md) · [All operations](https://skmtc.dev/optum/apis/namespace/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/optum/namespace/revisions/eed5055f8eb6/schema)