Lease documents

Create a lease document from a letter template

Builds a lease document from a saved DOCX signing template — a notice or letter rather than a full lease — filling in the lease's own values as it goes.

POST

https://api.portal.magicdoor.com/company-app/lease-documents/from-letter-template

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

leaseIdstringrequired

The lease the document is for. A Snowflake id, sent as a decimal string.

signingDocumentTemplateIdstringrequired

The DOCX signing template to build from. A Snowflake id, sent as a decimal string.

namestringrequired

Name for the document. 1 to 150 characters.

propertyManagerIdsstring[]

Property managers to add as signers alongside the lease's tenants.

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 · The request failed validation. `errors` maps each field name to what was wrong with it.

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

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

curl --request POST \ --url 'https://api.portal.magicdoor.com/company-app/lease-documents/from-letter-template' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "leaseId": "1830472847398404096", "signingDocumentTemplateId": "1843019384756201984", "name": "Late rent notice", "propertyManagerIds": [ "1854019384756201984" ] }'

{ "id": "1842019384756201984", "portfolioId": "1827741029384756224", "propertyId": "1829933847562019840", "unitId": "1832019384756201984", "leaseId": "1830472847398404096", "leaseTemplateIds": [ "1843019384756201984" ], "fileId": "1838475620198404096", "name": "Residential lease agreement", "status": "draft", "type": "lease", "signers": [ { "id": "1831856473920184832", "name": "Dana Whitfield", "type": "tenant", "signatureStatus": "draft", "signatureName": "Dana Whitfield", "signatureInitials": "DW", "emailSignature": { "destination": "dana.whitfield@example.com", "type": "email", "sentDate": "2026-02-24T13:10:00" } } ], "annotations": [ { "id": "sig-tenant-1", "signerId": "1831856473920184832", "page": 6, "x": 0.12, "y": 0.72, "width": 0.3, "height": 0.06, "fontSize": 12, "type": "signature", "isInputField": true, "isVisible": true, "isMandatory": true } ], "file": { "id": "1838475620198404096", "created": "2026-08-14T10:22:41", "name": "lease-agreement.pdf", "extension": "pdf", "size": 284193, "contentType": "application/pdf", "secureUrl": { "base": "https://files.magicdoor.com", "raw": "/f/1838475620198404096/raw", "variantTemplate": "/f/1838475620198404096/{variant}" }, "fileId": "1838475620198404096", "fileName": "lease-agreement.pdf", "signedUrl": "https://files.magicdoor.com/f/1838475620198404096/raw?sig=abc123", "fileSize": 284193, "uploaded": "2026-08-14T10:22:41", "claimed": true } }