Emails

Get an email

Returns one email with its full body, its attachments, and the record behind every address it went to.

GET

https://api.portal.magicdoor.com/company-app/emails/{emailId}

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

emailIdstringrequired

The email to fetch.

example: 1831287365623406592

Response

200 · The email.

idstring

The email.

subjectstring

The subject line.

bodystring

The body as it was sent.

sentstring · date-time

When it was sent.

templateenum<string>

Which MagicDoor template wrapped the body. Emails sent through this API use companyGeneric.

emptycompanyGenericmagicDoor

targetsobject[]

Everyone it went to, with the record behind each address.

filesFile[]

The attachments that were sent with it.

propertyManagerobject

The property manager who sent it. Absent when MagicDoor sent it automatically.

metadataobject

Free-form key/value data MagicDoor stored with the email.

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

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

Request

curl --request GET \
  --url 'https://api.portal.magicdoor.com/company-app/emails/1831287365623406592' \
  --header 'Authorization: Bearer <token>'

Response

{
  "id": "1831287365623406592",
  "subject": "Water shut-off Thursday",
  "body": "<p>Water will be off Thursday 9am to 1pm for a repair.</p>",
  "sent": "2026-08-17T14:05:00",
  "template": "companyGeneric",
  "targets": [
    {
      "email": "marcus.webb@example.com",
      "tenants": [
        {
          "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"
        }
      ],
      "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": []
      }
    }
  ],
  "files": [
    {
      "id": "1830998877310976000",
      "name": "inspection-report.pdf",
      "extension": "pdf",
      "size": 184320,
      "contentType": "application/pdf",
      "created": "2026-08-14T09:12:44",
      "secureUrl": {
        "base": "https://files.magicdoor.com",
        "raw": "/f/1830998877310976000/inspection-report.pdf",
        "variantTemplate": "/f/1830998877310976000/{variant}/inspection-report.pdf"
      }
    }
  ],
  "propertyManager": {
    "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"
  }
}