Chats

Assign a chat

Hands a chat to a property manager, or takes the assignment away. MagicDoor records who made the change.

PUT

https://api.portal.magicdoor.com/company-app/chats/{chatId}/assignee

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

chatIdstringrequired

The chat to assign.

example: 1830472847398404096

Body

application/json

propertyManagerIdstring

The property manager to hand the chat to. Send it without a value to leave the chat unassigned.

example: 1820011923988709376

Response

200 · The chat, with its new assignee.

idstring

The chat.

typeenum<string>

What the chat hangs off. A lease, maintenanceRequest, workOrder, or workOrderGroup chat is one conversation shared by several people; unknown is a chat keyed on a bare phone number.

leasetenantvendormaintenanceRequestworkOrderworkOrderGroupunknownowner

typeKeystring

The id of the thing the chat hangs off — a lease id for a lease chat, a phone number for an unknown chat.

subjectstring

The chat's title.

participantsChatParticipant[]

Everyone in the conversation. A lease or group chat lists every tenant here, not one chat each.

participantLanguagestring

ISO 639-1 code messages are translated into for the participants.

closedboolean

Whether the chat is archived. Sending a message to an archived chat reopens it.

pinnedboolean

Whether the chat is pinned in the portal.

groupNumberstring

The MagicDoor phone number this chat's SMS traffic uses. Present on lease, maintenance request and work order chats.

messageCountinteger

How many messages the chat holds.

unreadMessagesinteger

How many messages your company has not read yet.

latestMessageIdstring

The most recent message.

lastMessageSentAtstring · date-time

When the most recent message was sent.

latestMessageobject

The most recent message in full.

assignedPropertyManagerobject

The property manager who owns this chat. Absent when unassigned.

assignedByPropertyManagerobject

The property manager who made the assignment. Absent when MagicDoor assigned it rather than a person.

assignedAtstring · date-time

When the assignment was made.

humanEngagementRequestedstring · date-time

When the AI flagged this chat as needing a person to reply. Absent when it is not flagged.

leaseobject

The lease behind the chat, when there is one.

propertyTypeenum<string>

The kind of building, when the chat has a lease.

singleFamilymultiFamilycommercialcondotownHomeother

propertyIdstring

The property behind the chat.

unitIdstring

The unit behind the chat.

propertyImageIdstring

The property photo. Only set on maintenance request chats.

unitImageIdstring

The unit photo. Only set on maintenance request chats.

createdstring · date-time

When the chat was created.

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

404 · No chat with that id belongs to your company.

curl --request PUT \ --url 'https://api.portal.magicdoor.com/company-app/chats/1830472847398404096/assignee' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "propertyManagerId": "1820011923988709376" }'

{ "id": "1830472847398404096", "type": "lease", "typeKey": "1829833104612495360", "subject": "4B - Willow Creek", "participants": [ { "id": "1830472847398404100", "participantType": "tenant", "accountId": "1827991044238376960", "fullName": "Marcus Webb", "phoneNumber": "(208) 555-0117", "email": "marcus.webb@example.com", "active": true, "tenant": { "id": "1827991044238376960", "active": true, "firstName": "Marcus", "lastName": "Webb", "email": "marcus.webb@example.com", "phone": "(208) 555-0117", "language": "en", "chatId": "1830472847398404096", "portalStatus": "active", "lastSeen": "2026-08-16T19:41:07", "icons": [], "created": "2026-02-11T10:05:33", "updated": "2026-07-30T16:22:09" } } ], "participantLanguage": "en", "closed": false, "pinned": false, "groupNumber": "(208) 555-0100", "messageCount": 14, "unreadMessages": 0, "latestMessageId": "1831055120837640192", "lastMessageSentAt": "2026-08-17T14:32:10", "created": "2026-03-01T09:00:00", "assignedPropertyManager": { "id": "1820011923988709376", "companyId": "1810119284757463040", "email": "dana@brightsidepm.com", "phone": "(208) 555-0142", "firstName": "Dana", "lastName": "Ortiz", "name": "Dana Ortiz", "active": true, "created": "2025-11-03T08:20:15", "lastSeen": "2026-08-17T13:58:02" }, "assignedAt": "2026-08-10T11:04:23", "lease": { "id": "1829833104612495360", "portfolioId": "1823772785993383936", "propertyId": "1824559920033832960", "unitId": "1828440183928913920", "start": "2026-03-01", "end": "2027-02-28", "ended": false, "monthToMonth": false, "eviction": false, "draft": false, "status": "lease", "expiringStatus": "none", "chatId": "1830472847398404096", "tenants": [ { "tenantId": "1827991044238376960", "moveIn": "2026-03-01" } ], "balance": 0, "postedBalance": 0, "currentRent": 1850, "securityDepositRequested": 1850, "securityDepositPaid": 1850, "securityDepositDue": 0, "lastPaymentDate": "2026-08-01", "icons": [] }, "propertyType": "multiFamily", "propertyId": "1824559920033832960", "unitId": "1828440183928913920" }