Property managers

Upload a profile photo directly

The older way to set a profile photo: post the image file itself as multipart/form-data in one call, with no upload session. It still works, and is kept for callers that cannot do the three-step upload.

Reserve an upload session, upload the file to it, then call set a profile photo.

POST

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

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

multipart/form-data

One part named imageFile holding the image. It must not be empty, must be an image type, and must be no larger than 5 MB.

imageFilefilerequired

The image to use as the profile photo.

Response

200 · The property manager, now carrying the new photo.

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.

400 · No file was sent, or the file was empty.

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 · The property manager has been deactivated.

Same path, two request shapes

This endpoint and set a profile photo share the address /company-app/property-managers/{propertyManagerId}/image. Sending multipart/form-data reaches this one; sending JSON reaches the other.