MagicDoorAPI
SupportOpen MagicDoor
Damage waivers

Opt a lease into the damage waiver

Undoes an opt-out so the lease can take part in the damage waiver program again, and optionally pins a fee for this lease alone. It does not enroll or charge the lease straight away: the lease rejoins the normal flow of notice, grace period, then enrollment. Requires the leasing_insurance:write permission.

POST
https://services.magicdoor.com/tenantinsurance/company-portal/insurance/damage-waivers/leases/{leaseId}/opt-in

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

leaseIdstringrequired

The lease to opt back in.

example: 1842910736482304512

Body

application/json

The body is optional. Send it only to set a fee for this lease.

customMonthlyFeenumber

A monthly fee for this lease alone, in dollars, replacing the company fee. Must be 0 or more. Send the request without this field to put the lease back on the company fee.

Response

200 · The lease's damage waiver settings after the change.

leaseIdstring

The lease these settings are for.

isOptedOutboolean

True when this lease has been opted out of the damage waiver program.

statusenum<string>

Where the lease sits in the damage waiver flow. none is the resting state, including after the tenant produced their own insurance. inGracePeriod means a notice went out and the tenant still has time to upload proof of insurance. enrolled means the waiver is in force and being charged. cancelled means the waiver was called off, usually because other coverage took over.

noneinGracePeriodenrolledoptedOutcancelled
effectiveMonthlyFeenumber

The monthly fee this lease is actually charged, in dollars: the lease's own fee when it has one, otherwise the company's.

customMonthlyFeenumber

A fee set for this lease alone, in dollars. Absent when the lease uses the company fee.

companyMonthlyFeenumber

The company-wide damage waiver fee, in dollars.

recurringLeaseChargeChartOfAccountobject

The company's revenue account the monthly damage waiver charge is posted to.

gracePeriodEndsAtstring · date-time

When the tenant's window to upload their own insurance closes, after which the lease is enrolled in the waiver automatically. Absent when no grace period is running.

latestNoticeSentAtstring · date-time

When the most recent damage waiver notice went out. Absent when none has been sent.

noticeTypestring

Why the most recent notice was sent: Initial for a lease with no insurance, Expired when previous insurance ran out, Rejected when uploaded proof was turned down. Absent when no notice has been sent. Sent capitalised, unlike the enum values elsewhere in this API.

InitialExpiredRejected
nextChargeDatestring · date-time

When the next monthly damage waiver charge is due. Absent when no waiver is currently in force.

policyStartDatestring · date-time

When the current waiver started. Absent when none is in force.

policyEndDatestring · date-time

When the current waiver ends. Absent when none is in force or it has no end date.

401 · The access token is missing, expired, or not a company portal token.

403 · The token is valid but the caller does not hold the `leasing_insurance:write` permission.

404 · No such lease, or the lease belongs to another company.