MagicDoorAPI
SupportOpen MagicDoor
Property managers

Set a property manager's password

Sets a new sign-in password for a colleague. It does not ask for their current password and does not sign them out of sessions they already have. MagicDoor emails them to say the password changed, without quoting it.

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

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

The new password. 5 to 150 characters.

clearTextPasswordstringrequired

The password they will sign in with from now on. 5 to 150 characters.

Response

200 · The property manager. The response carries their record, not the password.

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.

400 · The password is shorter than 5 characters.

422 · The property manager has been deactivated. Reactivate them first.

What it does and does not do

It replaces the stored password for this person's MagicDoor sign-in, and nothing else.

  • It does not sign them out. Sessions and access tokens they already hold keep working until they expire on their own.
  • It does not ask for the old password, and there is no check that the caller is a more senior colleague. Any property manager in the company can reset any other's password through this endpoint.
  • It does not change their permissions, property access or menu access.
  • It refuses a deactivated property manager with 422.
A confirmation email is sent

MagicDoor emails the property manager to tell them their password was changed. Unlike the tenant equivalent, that message does not contain the new password — you have to pass it on yourself.