Skip to main content

Email

NewBeta

The Email detail endpoint returns the full body, headers, and attachments for a single email in AppFolio®. Use /v1/emails to list emails for a guest card first, then fetch individual email bodies by emailId.

The Email Object

Attributes


appfolioIdstring
AppFolio ID of the email.
Example:
"123456789"

directionstring
Direction of the email (e.g. outbound or inbound).
Example:
"outbound"

subjectstring
Subject line of the email.
Example:
"Gate code has changed!!"

bodystring
Raw HTML body of the email as returned by AppFolio.
Example:
"<html><body style=\"margin: 0px\"><span style=\"font-family:sans-serif;font-size:13px;\">Hello!<br><br>This is to let you know that the new gate code is 1-2-3-4. Have a nice day!</span></body></html>"

fromstring
Sender email address.
Example:
"management@___.com"

tostring[]
List of recipient email addresses.
Example:
["tenant@_____.com"]

ccstring
Comma-separated list of CC'd email addresses.
Example:
""

bccstring
Comma-separated list of BCC'd email addresses.
Example:
""

sentAtstring
Date and time the email was sent or received.
Example:
"2026-04-13T06:21:49.000Z"

createdAtstring
Date and time the email record was created in AppFolio.
Example:
"2026-04-13T06:21:49.000Z"

updatedAtstring
Date and time the email record was last updated in AppFolio.
Example:
"2026-04-13T06:21:49.000Z"

attachmentsFileReference[]
List of attachments on the email. Each entry is a lightweight File reference with "fileId" and "name". Hydrate to a full File (signed URL, content type, size) via /v1/file?id=<fileId>.
Example:
[{"fileId":"145229","name":"Attachment Gate Change Letter.pdf"}]

The Email Object
{
"appfolioId": "123456789",
"direction": "outbound",
"subject": "Gate code has changed!!",
"body": "<html><body style=\"margin: 0px\"><span style=\"font-family:sans-serif;font-size:13px;\">Hello!<br><br>This is to let you know that the new gate code is 1-2-3-4. Have a nice day!</span></body></html>",
"from": "management@___.com",
"to": [
"tenant@_____.com"
],
"cc": "",
"bcc": "",
"sentAt": "2026-04-13T06:21:49.000Z",
"createdAt": "2026-04-13T06:21:49.000Z",
"updatedAt": "2026-04-13T06:21:49.000Z",
"attachments": [
{
"fileId": "145229",
"name": "Attachment Gate Change Letter.pdf"
}
]
}

Get an Email

GET /v1/email?emailId=<emailId>

Follows: AuthenticationCachingPollingList Response FormatScheduled Job

The email endpoint returns the body and full details of a single email in your AppFolio® account. This endpoint should respond immediately with your most recently cached data.

Parameters


emailIdstring
AppFolio ID of the email to fetch.

 

Returns


The standard List Response Format with a data array containing a single Email object.

GET /v1/email?emailId=772282340
curl -X GET 'https://api.skywalkapi.com/v1/email?emailId=772282340' \ 
-H "X-API-Key: PUT_YOUR_API_KEY_HERE"
Response
{
"meta": {
"status": "ok",
"path": "/v1/email",
"query": {
"emailId": "772282340"
},
"count": 1,
"lastUpdated": 1610992228
},
"data": [
{
"appfolioId": "123456789",
"direction": "outbound",
"subject": "Gate code has changed!!",
"body": "<html><body style=\"margin: 0px\"><span style=\"font-family:sans-serif;font-size:13px;\">Hello!<br><br>This is to let you know that the new gate code is 1-2-3-4. Have a nice day!</span></body></html>",
"from": "management@___.com",
"to": [
"tenant@_____.com"
],
"cc": "",
"bcc": "",
"sentAt": "2026-04-13T06:21:49.000Z",
"createdAt": "2026-04-13T06:21:49.000Z",
"updatedAt": "2026-04-13T06:21:49.000Z",
"attachments": [
{
"fileId": "145229",
"name": "Attachment Gate Change Letter.pdf"
}
]
}
]
}