Maintenance request categories

Create a maintenance request category

Creates a maintenance request category for the company and returns it. Requires the maintenance_request_categories:write permission.

POST
https://services.magicdoor.com/maintenance/company-portal/maintenance-requests/categories

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

namestringrequired

The category name shown to staff, for example "Plumbing". Between 1 and 150 characters, and it must not match a category the company already has.

descriptionstring

A longer explanation of what belongs in the category. At most 2000 characters.

Response

200 · The category that was created.

idstringrequired

The new category.

companyIdstringrequired

The company that owns the category, taken from the access token.

namestringrequired

The category name.

descriptionstring

The explanation, absent when none was sent.

createdstring · date-timerequired

When the category was created, in the company's timezone and without an offset.

updatedstring · date-timerequired

When the category was last changed, in the company's timezone and without an offset.

401 · The request carried no valid access token.

403 · The token is not a property manager token, or it lacks the `maintenance_request_categories:write` permission.

409 · The company already has a category with that name.