WarmablyWarmablyDOCS
Search docs⌘K
Dashboard
API Reference/Endpoints

Retrieve an email

GET/api/linkedin/gateway/emails/{email_id}

Fetches a single email, including its full HTML and plain-text body.

Authentication

Send your personal API key as a bearer token. A missing, malformed or revoked key returns 401.

Path parameters

FieldTypeDescription
email_id *stringThe email's id.

Query parameters

FieldTypeDescription
account_id *stringThe connected account the email belongs to.
include_headersbooleanInclude the email's raw headers in the response.

Response fields

FieldTypeDescription
object"Email"Always this value.
idstringThe email's id.
subjectstringThe email subject line.
bodystringThe HTML body.
body_plainstringThe plain-text body.
from_attendeeobjectSender: display_name and identifier.
to_attendeesarrayRecipients, same shape as from_attendee.
has_attachmentsbooleanWhether the email carries attachments.
attachmentsarrayAttachment metadata: id, name, size, mime and so on — use Retrieve an email attachment to download one.
thread_idstringThe thread this email belongs to.
foldersarrayThe folder(s) currently holding this email.

Errors

·401 Unauthorized. The key is missing, malformed or has been rotated.·403 Forbidden. The account_id doesn't belong to this key.·404 Not Found. No email with that id belongs to this account.
CredentialsRequired
AuthorizationBearer wm_live_••••••••
RequestTry it
curl "https://api.warmably.com/api/linkedin/gateway/emails/7c1a9e42-6f3d-4b18-9e02-1a8f6d2c5b90?account_id=459993d2-b0e7-4b19-baf9-45252ca324cf" \
  -H "Authorization: Bearer wm_live_..."
Response
200 OK
{
  "object": "Email",
  "id": "7c1a9e42-6f3d-4b18-9e02-1a8f6d2c5b90",
  "account_id": "459993d2-b0e7-4b19-baf9-45252ca324cf",
  "type": "GOOGLE",
  "date": "2026-08-30T14:02:11.000Z",
  "role": "inbox",
  "folders": ["INBOX"],
  "subject": "Re: intro call next week",
  "body": "<p>Sounds good, Tuesday works.</p>",
  "body_plain": "Sounds good, Tuesday works.",
  "has_attachments": false,
  "thread_id": "th_88af21",
  "from_attendee": { "display_name": "Priya Shah", "identifier": "priya@example.com" }
}
No key yet? Create one from Dashboard → API Keys.