Property managers

Set a profile photo

Attaches an already-uploaded file as the property manager's profile photo, replacing whatever was there. Pass the session id you got from create a profile photo upload session.

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

application/json

uploadSessionIdstringrequired

The upload session whose file becomes the photo. A Snowflake id, sent as a decimal string.

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.

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 · No upload session id was sent.

422 · The property manager has been deactivated, or the upload session does not belong to this property manager.

Two endpoints share this path

This one takes JSON. There is also an older multipart/form-data version at the same address that takes the file directly — see upload a profile photo directly. Which one runs is decided by the Content-Type you send.

The previous photo is not removed by this call. Use delete a profile photo if you want the old file gone.