Letter template groups

List letter template groups

Returns a page of the folders a company files its letter templates under, newest first.

GET

https://services.magicdoor.com/communications/company-portal/letter-templates/groups

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

pageinteger

Which page to return, counting from 1.

default: 1example: 1

pageSizeinteger

How many records to return. Between 1 and 100; anything outside that range is rejected with a 400.

default: 50example: 50

searchstring

Keep only groups whose name contains this text, ignoring case.

Response

200 · A page of groups.

itemsLetterTemplateGroup[]

The groups on this page, newest first.

totalCountinteger

How many records match the filters, across every page.

totalPagesinteger

How many pages of this size the matching records fill.

pageinteger

The page that was returned.

pageSizeinteger

How many records were asked for per page.

400 · `page` is below 1, or `pageSize` is outside 1 to 100.

401 · The access token is missing, expired, or not a property-manager token.

Request

curl --request GET \
  --url 'https://services.magicdoor.com/communications/company-portal/letter-templates/groups?page=1&pageSize=50' \
  --header 'Authorization: Bearer <token>'

Response

{
  "items": [
    {
      "id": "1829911204830429184",
      "name": "Rent notices",
      "created": "2026-07-02T14:05:19",
      "updated": "2026-07-02T14:05:19"
    }
  ],
  "totalCount": 3,
  "totalPages": 1,
  "page": 1,
  "pageSize": 50
}