MagicDoorAPI
SupportOpen MagicDoor
Property owners

Add an owner to a property

Links an existing owner to a property with a share of it. The owner must already exist and both records must be active.

POST
https://api.portal.magicdoor.com/company-app/properties/{propertyId}/owners/{ownerId}

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

propertyIdstringrequired

Snowflake id of the property.

example: 1830472847398404097
ownerIdstringrequired

Snowflake id of the owner, from the owners endpoints.

example: 1830472847398404100

Body

application/json

ownershipPercentagenumberrequired

This owner's share of the property, as a percentage — send 50 for half. Not validated against the shares already on the property.

Response

200 · The new link, with the owner, property and portfolio expanded.

ownerOwner

The owner record, in the same shape the owners endpoints return.

propertyobject

The property, expanded.

portfolioobject

The portfolio behind the property, expanded.

ownershipPercentagenumber

This owner's share of the property, as a percentage such as 50.00.

400 · `propertyId` or `ownerId` is not a decimal number. The response carries an `errors` member mapping each rejected field name to its message.

401 · The access token is missing, expired, or not for this company.

404 · No property or no owner with that id, or one of them belongs to another company.

409 · This owner is already linked to this property. Use the update endpoint to change their share.

422 · The owner or the property has been deactivated.

How ownership is modelled

An owner is a person or company record of its own, created through the owners endpoints. Linking one to a property records a share — a percentage — and a property can carry several owners. MagicDoor does not require the shares on a property to add up to 100, so it is on you to keep them consistent.