MagicDoorAPI
SupportOpen MagicDoor
Property managers

Get a property manager

Fetches one property manager, active or not, with ready-to-use URLs for their profile photo.

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

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

Response

200 · The property manager.

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.

Two different gates

A property manager is limited in three independent ways, and it is easy to confuse them.

  • Permissions are resource:action strings such as property:read. They decide what the API lets this person do. See list permissions.
  • Property access decides which properties those permissions reach — all of them, or a named set of portfolios and properties. See get property access.
  • Menu access decides which top-level menus MagicDoor's own web app draws for them. It hides screens; it does not stop an API call. See get menu access.