MagicDoorAPI
SupportOpen MagicDoor
Company

Answer whether the company is self-managed

Records whether the company owns the properties it manages. When it does not, you must also name the bank account that receives management income, and may list further accounts that belong to the company rather than to owners.

PUT
https://api.portal.magicdoor.com/company-app/companies/self-managed

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

selfManagedbooleanrequired

True when the company owns the properties it manages.

defaultCompanyBankAccountIdstring

The bank account the company's own money goes to. Required when selfManaged is false. A Snowflake id sent as a decimal string.

companyBankAccountIdsstring[]

Further bank accounts to mark as belonging to the company rather than to owners.

Response

200 · The self-managed flag after the change.

selfManagedboolean

The answer that was recorded.

needChooseboolean

False once the question has been answered.

400 · `selfManaged` was false and `defaultCompanyBankAccountId` was missing, or a bank account id was not a valid Snowflake id.

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

Call GET /company-app/companies/self-managed/unassigned-bank-accounts first to see which accounts can be picked and which cannot.