---
title: "Set a tenant's consent to electronic delivery"
method: PUT
path: "/leases/{lease_id}/lessees/{lessee_id}/consent"
tags: ["Leases", "Lessees", "Rent Receipts"]
---

# Set a tenant's consent to electronic delivery

`PUT /leases/{lease_id}/lessees/{lessee_id}/consent`

## Request

- Base URL: `https://api.faireplace.com/api`
- URL: `https://api.faireplace.com/api/leases/{lease_id}/lessees/{lessee_id}/consent`
- Auth: HTTP bearer

Records, as the landlord, whether this tenant accepts receiving their
documents: rent receipts above all: by email (ALUR §6).

Consent is **per tenant and per lease**, and revocable: sending `false`
turns it off again. While it is `false`, the rent-receipt workflow will
not email that tenant.

Two other ways exist to reach the same flag, and they matter for how you
design your UI:

- `POST /leases/{lease_id}/lessees/{lessee_id}/request-consent`: email
  the tenant a one-click link so **they** grant it. Preferable when you
  want the consent evidenced as the tenant's own act.
- `PUT /tenant/leases/{lease_id}/consent`: the tenant sets it from
  their own portal.

Note `{lessee_id}` is the **person's** id, not the id of the
lease ↔ lessee association.

## Path parameters

- `lease_id` string, uuid, required
- `lessee_id` string, uuid, required

## Request body

- object
  - `electronic_delivery_consent` boolean, required: `true` to allow email delivery, `false` to revoke it.

## Response `200`

Consent recorded: the updated association is returned.

- LeaseLessee: Association of a lessee with a lease
  - `id` string, uuid, required: Unique identifier of the association
  - `lease_id` string, uuid, required: Associated lease ID
  - `lessee_id` string, uuid, required: Associated lessee ID
  - `role_type` 'PRIMARY' | 'CO_TENANT' | 'GUARANTOR', required: Role of the lessee in the lease
  - `rent_share` number, nullable: Rent share for this lessee (if co-tenancy)
  - `start_date` string, date, required: Start date of the association
  - `end_date` string, date, nullable: End date of the association
  - `created_at` string, date-time, required: Creation date
  - `updated_at` string, date-time, required: Last modification date
  - `created_by_amendment_id` string, uuid, nullable: Amendment ID that created this association
  - `ended_by_amendment_id` string, uuid, nullable: Amendment ID that ended this association
  - `guarantor_max_amount` number, nullable: Maximum guaranteed amount (if role = GUARANTOR)
  - `guarantor_conditions` string, nullable: Specific guarantee conditions
  - `guarantees_lessee_id` string, uuid, nullable: Lessee ID guaranteed by this guarantor (if role = GUARANTOR)
  - `guarantor_engagement_type` 'SIMPLE' | 'SOLIDAIRE', nullable: Nature of the surety's undertaking (if role = GUARANTOR). A guarantor with no `guarantor_max_amount` **and** no `guarantor_engagement_type` cannot be committed: the surety deed cannot be drawn up, and the signature pre-flight will report a `caution_incomplete` blocker. Any value other than `SIMPLE` or `SOLIDAIRE` is rejected: it is never silently treated as "unset".
  - `electronic_delivery_consent` boolean, required: Whether this tenant has consented to receiving documents: rent receipts in particular: by email (ALUR §6). Consent is per tenant **and** per lease, and is revocable. Rent receipts are not emailed to a tenant whose consent is `false`. Set it as the landlord with `PUT /leases/{lease_id}/lessees/{lessee_id}/consent`, ask the tenant for it with `POST /leases/{lease_id}/lessees/{lessee_id}/request-consent`, or let the tenant set it themselves from their portal with `PUT /tenant/leases/{lease_id}/consent`.
  - `consent_updated_at` string, date-time, nullable: When `electronic_delivery_consent` was last changed. `null` if never set.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not found
- `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)