MagicDoorAPI
SupportOpen MagicDoor
Property managers

List property managers

Returns every active property manager in the company, ordered by first name then last name. Deactivated colleagues are not included and there is no filter or paging to get them back.

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

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.

Response

200 · The company's active property managers.

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.

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.
Deactivated people are invisible here

This endpoint filters on active. To see a deactivated property manager, fetch them by id with get a property manager — that endpoint has no such filter.