---
title: "Create a rent reminder"
method: POST
path: "/leases/{lease_id}/rent-reminders"
tags: ["Rent Reminders"]
---

# Create a rent reminder

`POST /leases/{lease_id}/rent-reminders`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/leases/{lease_id}/rent-reminders`
- Auth: HTTP bearer

Create a rent reminder (relance) for unpaid rent periods.

**French law context (art. 24 loi 89-462):**
Before any legal proceedings, the landlord must demonstrate graduated reminders:
1. `FRIENDLY`: Amiable reminder (email/letter)
2. `FORMAL_NOTICE`: Mise en demeure (LRAR recommended)
3. `PAYMENT_ORDER`: Commandement de payer (via huissier)

The reminder is created with `DRAFT` status. Use `PUT /leases/{lease_id}/notices/{notice_id}/send` to mark it as sent.

**Permissions required:** `leases:write`

## Path parameters

- `lease_id` string, uuid, required

## Request body

- object
  - `reminder_type` 'FRIENDLY' | 'FORMAL_NOTICE' | 'PAYMENT_ORDER', required
  - `due_amount` number, required: Total amount due
  - `periods_covered` object[], required: JSON array of covered periods
    - `start` string, date
    - `end` string, date
  - `delivery_method` 'EMAIL' | 'LETTER' | 'LRAR', required
  - `tracking_number` string, nullable: LRAR tracking number
  - `notes` string, nullable

## Response `201`

Reminder created

- RentReminderResponse
  - `id` string, uuid
  - `lease_id` string, uuid
  - `reminder_type` 'FRIENDLY' | 'FORMAL_NOTICE' | 'PAYMENT_ORDER'
  - `sent_date` string, date, nullable
  - `due_amount` number
  - `periods_covered` object[]
  - `delivery_method` 'EMAIL' | 'LETTER' | 'LRAR'
  - `tracking_number` string, nullable
  - `status` 'DRAFT' | 'SENT' | 'ACKNOWLEDGED'
  - `document_url` string, nullable
  - `notes` string, nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401`: Unauthorized
- `403`: Forbidden

---

[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)