---
title: "Ask a tenant for their consent to email delivery"
method: POST
path: "/leases/{lease_id}/lessees/{lessee_id}/request-consent"
tags: ["Leases", "Lessees", "Rent Receipts"]
---

# Ask a tenant for their consent to email delivery

`POST /leases/{lease_id}/lessees/{lessee_id}/request-consent`

## Request

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

Emails the tenant a one-click link inviting them to authorise the
sending of their rent receipts by email.

Prefer this over setting the flag yourself with
`PUT /leases/{lease_id}/lessees/{lessee_id}/consent`: the consent is
then the tenant's own act, which is what ALUR §6 asks for.

The tenant follows the link to `GET /public/tenant/consent?token=…`,
which is public, single-use and time-limited: no login needed.

Queued, not sent inline, hence `202`. The response says the request was
accepted, not that the tenant consented.

Note `{lessee_id}` is the **person's** id.

## Path parameters

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

## Response `202`

Consent request accepted for delivery.

- object
  - `requested` boolean

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