MagicDoorAPI
SupportOpen MagicDoor
Application unit interests

Add a unit of interest

Records that the applicant is applying for a particular unit. You send only the unit — the property and portfolio it sits in are looked up for you. Requires the rental_applications:write permission.

POST
https://services.magicdoor.com/leasing/company-portal/rental-applications/{applicationId}/interests

Authorization

Authorizationstringrequired
Bearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.

Path parameters

applicationIdstringrequired

The rental application to work with. A Snowflake id, sent as a decimal string.

example: 1830472847398404096

Body

application/json

unitIdstringrequired

The unit the applicant wants. A Snowflake id, sent as a decimal string. It must belong to the same company as the application.

Response

200 · The new interest, with the property and portfolio resolved from the unit.

idstring

The interest record. Pass this id to remove it.

portfolioIdstring

The portfolio the unit's property sits in, resolved server-side.

propertyIdstring

The property the unit sits in, resolved server-side.

unitIdstring

The unit the applicant is interested in.

400 · The unit belongs to a different company than the rental application.

401 · The access token is missing, expired, or not valid.

403 · The caller is authenticated but does not hold the `rental_applications:write` permission.

404 · No unit with this id exists on this rental application, or the rental application itself was not found.

Allowed in every application status

This is not gated on the application's status — it works on a draft, on a submitted application, and on a retracted one. Only the applicant-facing portal locks an application once it is submitted.

Nothing stops duplicates

Adding the same unit twice creates two interest records. Check interestedUnits on the rental application before adding if that matters to you.

Richer detail lives on the application

This response carries the four ids only. interestedUnits on the rental application gives the same interests with the unit name, address, listed rent and deposit filled in.