MagicDoorAPI
SupportOpen MagicDoor
Business info

Set the primary business legal entity

Makes one approved legal entity the company's primary one, clearing the flag on whichever entity held it. Calling it on the entity that is already primary changes nothing. Requires the business_info:write permission.

PUT
https://services.magicdoor.com/companies/company-portal/business-info/{businessInfoId}/primary

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

businessInfoIdstringrequired

The business legal entity, as a Snowflake id in decimal string form.

example: 1842095537184571392

Response

200 · The entity, now primary.

idstringrequired

The business legal entity, as a Snowflake id in decimal string form.

displayLabelstringrequired

What to show in a list. The stored label if one was set, otherwise the legal name, otherwise EIN followed by the masked tax identifier, otherwise New business legal entity.

isPrimarybooleanrequired

Whether this is the company's primary legal entity. Always false for an entity that is still staged.

phaseenum<string>required

materialized means an approved record exists and can be used as the company's business identity. staged means the id has been allocated by an in-flight first-time draft and nothing is approved yet.

materializedstaged
statusenum<string>

Status of the open draft on this entity. Absent when no draft is open.

draftpendingReviewwaitingForInformationrejectedsuperseded
typeenum<string>

What the open draft is doing. Absent when no draft is open.

initialupdatesupplement
submittedstring · date-time

When the open draft was last sent for review, in the company's timezone. When no draft is open this carries the approved record's last-updated time instead. Absent when neither applies.

401 · The request carried no valid access token.

403 · The caller is not a property manager, or is missing the `business_info:write` permission.

404 · No approved legal entity with that id on this company.