Owners

Set an owner's password

Sets a new sign-in password for an owner, chosen by the property manager. It does not ask for the owner's current password, does not sign them out of sessions they already have, and does not tell them the password changed.

PUT

https://api.portal.magicdoor.com/company-app/owners/{ownerId}/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

ownerIdstringrequired

The owner. A Snowflake id, sent as a decimal string.

example: 1830472847398404097

Body

application/json

The new password. 1 to 150 characters as far as the request is concerned, but the change is refused below 5 characters.

passwordstringrequired

The password the owner will sign in with from now on.

Response

200 · The owner. The response carries the owner record, not the password.

idstring

The owner.

activeboolean

false once the owner has been deactivated. A deactivated owner cannot sign in and cannot be given a new password.

emailstring

Email address. Absent when none is on file.

firstNamestring

Given name, or the company name when isCompany is true.

lastNamestring

Family name. Absent for a company, or when only a first name is on file.

isCompanyboolean

true when the owner is a business rather than a person.

phonestring

Phone number, formatted for reading. Absent when none is on file.

federalTaxInformationobject

Tax identification used for the owner's 1099. Absent when none is on file.

createdstring · date-time

When the owner record was created.

updatedstring · date-time

When the owner record was last changed.

lastSeenstring · date-time

When the owner last used the owner portal. Absent when they never have.

lastPortalInvitestring · date-time

When a portal invite was last sent. Absent when none ever was.

chatIdstring

The owner's conversation with the company. Absent when no conversation exists.

languagestring

ISO 639-1 language code used for messages to this owner. Defaults to en.

iconsstring[]

Icon keys a property manager has pinned to the owner. Always present, possibly empty.

addressobject

The owner's mailing address.

portalStatusenum<string>

Where the owner is in getting onto the owner portal: notInvited, invited (invited but never signed in), active (has signed in).

notInvitedinvitedactive

ownerPropertiesobject[]

This owner's stake in each property they own, as a link record.

portfoliosobject[]

The portfolios holding those properties.

propertiesobject[]

The properties themselves.

paymentAccountsobject[]

The accounts MagicDoor can pay this owner through. Account and card numbers are reduced to their last four digits.

401 · The access token is missing, expired, or does not belong to a property manager.

404 · No owner 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 owner has been deactivated. Reactivate them first.

What it does and does not do

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

It does not sign the owner out. Sessions and access tokens they already hold keep working until they expire on their own.
It does not ask for the old password.
It sends no notification. Unlike the tenant equivalent, this endpoint tells the owner nothing — you have to pass the new password on yourself. Send an owner portal invite is the call that emails an owner a password.
It refuses a deactivated owner with 422.