MagicDoorAPI
SupportOpen MagicDoor
Property managers

Activate or deactivate a property manager

Turns a colleague's sign-in on or off. Deactivating keeps the person and everything they did; it only stops them signing in. You cannot change your own status, and you cannot deactivate the company's last active property manager.

PUT
https://api.portal.magicdoor.com/company-app/property-managers/{propertyManagerId}/active

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

propertyManagerIdstringrequired

The property manager. A Snowflake id, sent as a decimal string.

example: 1830472847398404098

Body

application/json

activebooleanrequired

true restores the sign-in, false disables it.

Response

200 · The property manager. Note that the record returned is read before the change is applied, so `active` may still show the old value; read the property manager back if you need to confirm it.

idstring

The property manager. This is also their MagicDoor user id.

companyIdstring

The company they work for.

emailstring

Email address, which is also the name they sign in with.

phonestring

Phone number. Absent when none is on file.

firstNamestring

Given name.

lastNamestring

Family name. Absent when only a first name is on file.

activeboolean

false once the property manager has been deactivated. A deactivated property manager cannot sign in and cannot be given a new password.

createdstring · date-time

When the property manager was added.

lastSeenstring · date-time

When they last used the company portal. Absent when they never have.

namestring

firstName and lastName joined with a space. Read-only.

imageIdstring

Their profile photo. Absent when they have none.

imageobject

Ready-to-use URLs for the profile photo. Absent when they have no photo.

401 · The access token is missing, expired, or does not belong to a property manager.

404 · No property manager with that id exists for the calling company. A record that belongs to another company is reported the same way as one that does not exist. The id you asked for is in `entityId`; `detail` names only the kind of record.

422 · Either you tried to change your own active status, or you tried to deactivate the company's last active property manager. The example shows the first case; note that `type` carries an exception name here rather than a URL, because this response is assembled by the controller rather than by the usual problem-details machinery. The last-active-property-manager case comes through the usual machinery instead, with `title` of `Unprocessable Entity` and `detail` of `Cannot deactivate the last active property manager for a company`.

Deactivate is not delete

Setting active to false disables the MagicDoor sign-in and nothing else. The property manager record stays, they keep showing up as the creator of everything they created, and their permissions and property access are kept as they were. Set active back to true and they can sign in again with the same password.

Deactivated property managers vanish from list property managers, which filters on active. Fetch them by id instead.

Setting it to what it already is does nothing

If active already matches, the call returns without touching anything.