MagicDoorAPI
SupportOpen MagicDoor
Lease documents

Create a lease document (multipart)

Creates a lease document by uploading the PDF in one multipart request. Kept for older integrations; new work should request an upload session and then create the document by its session id.

Request an upload session, upload the PDF there, then create the document with the JSON endpoint.
POST
https://api.portal.magicdoor.com/company-app/lease-documents

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

multipart/form-data

filefilerequired

The PDF itself. Must not be empty.

leaseIdstringrequired

The lease the document belongs to. A Snowflake id, sent as a decimal string.

namestringrequired

Name for the document.

leaseTemplateIdsstring[]

Lease templates the document relates to.

Response

200 · The document that was created.

idstring

Id of the lease document. A Snowflake id, sent as a decimal string.

portfolioIdstring

Portfolio the lease rolls up to. A Snowflake id, sent as a decimal string.

propertyIdstring

Property the lease is on. A Snowflake id, sent as a decimal string.

unitIdstring

Unit the lease is on. A Snowflake id, sent as a decimal string.

leaseIdstring

The lease the document belongs to. A Snowflake id, sent as a decimal string.

leaseTemplateIdsstring[]

The lease templates the document was built from.

fileIdstring

The stored PDF. A Snowflake id, sent as a decimal string.

namestring

Name of the document.

statusenum<string>

Where the document stands: draft while it is being prepared, pendingSignatures once it has gone out, completed once everyone has signed, retracted if it was pulled back.

draftpendingSignaturescompletedretracted
typeenum<string>

Whether this is a lease document or a lease renewal document.

leaseleaseRenewal
signersLeaseDocumentSigner[]

Who has to sign, and how far each of them has got.

annotationsLeaseDocumentAnnotation[]

The boxes placed on the PDF — signatures, initials, dates and filled-in values.

fileobject

The stored PDF, resolved to a full file record.

400 · No file was sent, or the file was empty.

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

404 · No lease or template matched the id, or it belongs to another company.