Owner transfers

Record an owner contribution

Records money an owner has put into one of their properties. The amount is added to that property's balance and posted as a deposit.

POST
https://api.portal.magicdoor.com/company-app/owners/contributions

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.

Body

application/json

ownerIdstringrequired

The owner putting money in. Must belong to the caller's company and be active.

propertyIdstringrequired

The property the money goes into.

contributionDatestring · daterequired

The day the money was contributed.

amountnumberrequired

How much the owner contributed, in dollars and cents. At least 1.00. Always positive — money coming into the property.

memostring

A note on the contribution. At most 1000 characters.

referencestring

A reference on the contribution. At most 200 characters.

paymentMethodenum<string>

How the owner actually sent the money.

achdebitCardwalletcreditCardcheckcashiersCheckmoneyOrdercashzelleothercredittransfer
externalTransactionIdstring

The reference from whatever system actually moved the money. At most 100 characters.

metadataobject

Free-form key-value pairs to keep on the contribution.

Response

200 · The contribution that was recorded.

idstring

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

ownerIdstring

The owner who put the money in.

contributionDatestring · date

The day the money was contributed.

totalAmountnumber

How much the owner contributed, in dollars and cents. Always positive — money coming into the property from the owner.

allocatedAmountnumber

How much of it has been matched to an accounting transaction.

dueAmountnumber

What has not yet been matched: totalAmount less allocatedAmount.

memostring

A note on the contribution. Absent when none was set.

referencestring

A reference on the contribution. Absent when none was set.

lineItemsobject[]

The contribution broken down by property, in display order.

filesobject[]

Files attached to the record.

metadataobject

Free-form key-value pairs kept on the contribution.

createdstring · date-time

When the contribution was created, in the company's timezone.

updatedstring · date-time

When it last changed, in the company's timezone.

creatorobject

Who created the record.

ownerobject

The owner named by ownerId, as the full owner record.

portfoliosobject[]

The portfolios the lines belong to, resolved.

propertiesobject[]

The properties the lines apply to, resolved.

transactionsobject[]

The accounting transactions behind the allocations, resolved.

bankAccountsobject[]

The bank accounts those transactions moved money through, resolved. Account and routing numbers are masked to their last four digits.

chartOfAccountsobject[]

The chart of accounts the lines book to, resolved.

hydratedFilesobject[]

The attachments in files, resolved to full file records with signed download URLs.

creatorInfoobject

The person behind creator, resolved. Exactly one of propertyManager, vendor, tenant and owner is present, matching creator.type.

400 · `amount` is below 1.00, or a required field is missing.

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

404 · The owner or property does not exist for the caller's company.

422 · The owner is deactivated, or the accounting service refused the contribution.