---
title: "Create multiple lessees"
method: POST
path: "/lessees/bulk"
tags: ["Lessees"]
---

# Create multiple lessees

`POST /lessees/bulk`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/lessees/bulk`
- Auth: HTTP bearer

Creates multiple lessees in a single operation

## Request body

- CreateLesseesBulk: Bulk creation of lessees
  - `lessees` CreateLessee[], required: List of lessees to create
    - `category` 'individual' | 'company/other' | 'guarantor', required: Lessee category
    - `title` string: Title (Mr., Mrs., etc.)
    - `first_name` string: First name (required for individuals)
    - `last_name` string: Last name
    - `legal_name` string: Legal name (required for companies)
    - `birth_date` string, date, nullable: Date of birth
    - `birth_place` string: Place of birth
    - `email` string, email, required: Email address
    - `mobile_phone` string: Mobile phone number
    - `landline_phone` string: Landline phone number
    - `address_country` string: Country
    - `address_complement` string: Address complement
    - `address_street_number` string: Street number
    - `address_street_name` string: Street name
    - `address_locality` string: Locality, district, or borough
    - `address_postal_code` string: Postal code
    - `address_city` string: City
    - `address_postal_box` string: PO Box
    - `profession` string: Profession
    - `employer_name` string: Employer name
    - `employer_phone` string: Employer phone
    - `monthly_income` number: Monthly income
    - `other_income` number: Other income
    - `bank_name` string: Bank name
    - `iban` string: IBAN code
    - `bic` string: BIC/SWIFT code
    - `additional_addresses` object: Additional addresses (JSON)
    - `identity_documents` object: Identity documents (JSON)
    - `additional_contacts` object: Additional contacts (JSON)
    - `custom_fields` object: Custom fields (JSON)
    - `auth_user_id` string: Better Auth user ID

## Response `201`

Lessees created successfully

- Lessee[]
  - `id` string, uuid, required: Unique identifier of the lessee
  - `category` 'individual' | 'company/other' | 'guarantor', required: Lessee category
  - `title` string: Title (Mr., Mrs., etc.)
  - `first_name` string: First name
  - `last_name` string: Last name
  - `legal_name` string: Legal name (for companies)
  - `birth_date` string, date, nullable: Date of birth
  - `birth_place` string: Place of birth
  - `email` string, email: Email address
  - `mobile_phone` string: Mobile phone number
  - `landline_phone` string: Landline phone number
  - `address_country` string: Country
  - `address_complement` string: Address complement
  - `address_street_number` string: Street number
  - `address_street_name` string: Street name
  - `address_locality` string: Locality, district, or borough
  - `address_postal_code` string: Postal code
  - `address_city` string: City
  - `address_postal_box` string: PO Box
  - `profession` string: Profession
  - `employer_name` string: Employer name
  - `employer_phone` string: Employer phone
  - `monthly_income` number, nullable: Monthly income
  - `other_income` number, nullable: Other income
  - `bank_name` string: Bank name
  - `iban` string: IBAN code
  - `bic` string: BIC/SWIFT code
  - `additional_addresses` object, nullable: Additional addresses (JSON)
  - `identity_documents` object, nullable: Identity documents (JSON)
  - `additional_contacts` object, nullable: Additional contacts (JSON)
  - `custom_fields` object, nullable: Custom fields (JSON)
  - `auth_user_id` string, nullable: Better Auth user ID
  - `created_at` string, date-time, required: Creation date
  - `updated_at` string, date-time, required: Last modification date

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/faireplace/apis/faireplace-property-management-api.md) · [All operations](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/faireplace/apis/faireplace-property-management-api/revisions/69de39762919?raw)