---
title: "Inbound emails"
description: "Read email your receiving-enabled domains have received — list messages, retrieve full bodies, and download attachments via short-lived signed URLs."
url: https://www.unitpost.com/docs/api/inbound-emails
section: API reference
updated: 2026-07-31
---
# Inbound emails

## Inbound emails

> Read email your receiving-enabled domains have received — list messages, retrieve full bodies, and download attachments via short-lived signed URLs.

Full schemas: [OpenAPI 3.1](https://www.unitpost.com/api/v1/openapi.json). HTML reference: https://www.unitpost.com/docs/api/inbound-emails.

## Operations

### `GET /api/v1/email/received`

List received emails

Retrieve a list of inbound emails received on your receiving-enabled domains, newest-first and cursor-paginated. Rows are summaries (sender, subject, timestamps) without bodies — use a message's `id` with [Retrieve a received email](#get-email-received-id) to read the full content and attachment metadata. Requires the `emails:read` capability.

### `GET /api/v1/email/received/{id}`

Retrieve a received email

Retrieve a full inbound message by `id`, including its HTML and text bodies plus metadata for every attachment. Attachment bytes aren't inlined — download each one via [Get an attachment download URL](#get-email-received-id-attachments-attachmentid). Browse your inbound mail with [List received emails](#get-email-received). Requires the `emails:read` capability.

### `GET /api/v1/email/received/{id}/attachments/{attachmentId}`

Get an attachment download URL

Get a short-lived, signed URL for downloading one inbound attachment's bytes. Fetch the URL and download promptly — it expires quickly (the expiry is included in the response). Find attachment ids on the message via [Retrieve a received email](#get-email-received-id). Requires the `emails:read` capability.

## Related

- [Contacts](https://www.unitpost.com/docs/api/contacts): Manage the people you email. Create and update contacts one at a time or import thousands in the background, with standard and custom field values that templates can reference as variables.
- [Contact fields](https://www.unitpost.com/docs/api/contact-fields): Define the typed custom attributes (text, number, date, …) your contacts carry — usable in templates as per-recipient variables.
- [Segments](https://www.unitpost.com/docs/api/segments): Named groups of contacts used to target campaigns. Segments decide who a campaign goes to; topics (below) decide what recipients can opt out of.