Damage waivers

Update damage waiver settings

Turns the company's damage waiver program on or off and changes the tenant fee, the grace period, and the accounts the charges post to. Returns the settings as they now stand. Requires the leasing_insurance:write permission.

PATCH

https://services.magicdoor.com/tenantinsurance/company-portal/insurance/damage-waivers/settings

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

Every field is optional, and an omitted field keeps its stored value.

enrolledInDamageWaiverProgramboolean

Whether the company runs the damage waiver program. Turning it on for the first time stamps the enrollment date and makes MagicDoor responsible for insurance notices. Turning it off hands notices back and cancels every grace period in progress.

monthlyFeenumber

The monthly damage waiver fee charged to a tenant, in dollars. Must be 0 or more.

gracePeriodInDaysinteger

How many days a tenant gets to upload their own insurance after a notice before the waiver is applied. Must be 0 or more.

recurringLeaseChargeChartOfAccountIdstring

The account the monthly tenant charge posts to. Must be one of the company's own revenue accounts and must not be deleted.

companyExpenseChartOfAccountIdstring

The account used when MagicDoor bills the company for its enrollments. Must be one of the company's own expense accounts and must not be deleted.

Response

200 · The settings after the change.

companyIdstring

The company these settings belong to.

enrolledInDamageWaiverProgramboolean

True when the company runs the damage waiver program. While it is on, MagicDoor sends the insurance notices and enrolls uninsured leases once their grace period ends.

enrollmentDatestring · date-time

When the company first turned the program on. Leases that started before this date are never enrolled automatically and need a notice campaign. Absent when the company has never enrolled.

monthlyFeenumber

The monthly damage waiver fee charged to a tenant, in dollars. Defaults to 23.00 until changed.

gracePeriodInDaysinteger

How many days a tenant gets to upload their own insurance after a notice before the waiver is applied. Defaults to 7.

recurringLeaseChargeChartOfAccountIdstring

The revenue account the monthly tenant charge is posted to.

companyExpenseChartOfAccountIdstring

The expense account used when MagicDoor bills the company for its damage waiver enrollments.

damageWaiverCostnumber

What MagicDoor charges the company per enrolled lease each month, in dollars. Compare it with monthlyFee to see the company's margin.

unitCountinteger

The unit count recorded on the company's onboarding record. 0 when there is no onboarding record.

createdstring · date-time

When the settings record was created.

updatedstring · date-time

When the settings last changed.

400 · A fee or grace period was negative, or a chart of account was given that is not of the required type.

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 · A chart of account id in the request does not exist for this company, or has been deleted.

Always send enrolledInDamageWaiverProgram

The program side effects are decided from the value in the request, and a missing enrolledInDamageWaiverProgram counts as false. So a request that only changes, say, monthlyFee on an enrolled company hands the insurance notices back to the generic platform flow and cancels every grace period in progress, even though the stored flag stays true. Send the flag on every call.