---
title: "Create a tenancy"
method: POST
path: "/inventory/{inventoryId}/tenancies"
tags: ["Tenancies"]
---

# Create a tenancy

`POST /inventory/{inventoryId}/tenancies`

## Request

- Base URL: `https://api.alto.zoopladev.co.uk`
- URL: `https://api.alto.zoopladev.co.uk/inventory/{inventoryId}/tenancies`
- Auth: `appAuth` (a scheme the document does not define)

Asynchronously creates a proposed tenancy. Use the returned TenancyId to poll /tenancies/{tenancyId} to check if the tenancy is created.

## Path parameters

- `inventoryId` integer, required

## Headers

- `AgencyRef` string, required

## Request body

- AltoPropertyManagementApiModelsRequestsCreateProposedTenancyRequest
  - `rentalAmount` number, double: The rental amount for the proposed tenancy.
  - `applicantContactIds` integer[], nullable: The ids of all the applicants for the proposed tenancy.
  - `tenancyStartDate` string, date-time, nullable: The Start Date of the proposed tenancy.
  - `tenancyTermMonths` integer, nullable: The term of the proposed tenancy in months.
  - `tenancyTermYears` integer, nullable: The term of the proposed tenancy in years.
  - `sendDefaultLetters` boolean: Whether to send default letters for the proposed tenancy.

## Response `202`

Accepted

## Other responses

- `400`: Bad Request

---

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