MagicDoorAPI
SupportOpen MagicDoor
Announcements

List announcements

Returns the announcements your company has sent or scheduled, with the properties they touched. The response is not paged.

GET
https://api.portal.magicdoor.com/company-app/announcements

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.

Query parameters

sentAt.startstring · date-time

Only return announcements sent on or after this moment.

example: 2026-08-01T00:00:00
sentAt.endstring · date-time

Only return announcements sent on or before this moment.

leaseIdsstring[]

Only return announcements that went to these leases. Repeat the parameter once per id.

ownerIdsstring[]

Only return announcements that went to these owners.

vendorIdsstring[]

Only return announcements that went to these vendors.

unitIdsstring[]

Only return announcements that reached these units.

propertyIdsstring[]

Only return announcements that reached these properties.

portfolioIdsstring[]

Only return announcements that reached these portfolios.

Response

200 · The matching announcements.

announcementsobject[]

The announcements, in summary form.

propertiesProperty[]

The properties referenced by those announcements, so you can show names without another call.

401 · The access token is missing, expired, or not valid.

This list gives a summary of each announcement. Fetch one by id to see exactly who it went to and whether each recipient could be reached.