---
title: "Canonical inbound ingress (standard.v1 payload)"
method: POST
path: "/v1/inbound"
tags: ["Inbound"]
---

# Canonical inbound ingress (standard.v1 payload)

`POST /v1/inbound`

## Request

- Base URL: `https://api.thrd.email`
- URL: `https://api.thrd.email/v1/inbound`
- Auth: none declared

## Request body

- object
  - `secret` string
  - `source` string: Optional source label for traceability.
  - `payload_format` 'standard.v1' | 'raw'
  - `timestamp` integer, required
  - `nonce` string, required
  - `recipient` string, email, required
  - `payload` union, required
    - object
      - `raw_mime` string
      - `message_id` string
      - `date` string, date-time
      - `from` string, email, required
      - `to` string[], required
      - `cc` string[]
      - `reply_to` string, email
      - `subject` string
      - `text` string
      - `html` string
      - `in_reply_to` string
      - `references` string[]
      - `headers` object
      - `attachments` object[]
        - `filename` string, required
        - `mime` string, required
        - `content_base64` string, required
        - `size` integer
    - object: Legacy/raw payload mode. Prefer standard.v1 payload.

## Response `202`

Accepted for async processing

---

[API](https://skmtc.dev/thrd/apis/thrd-agent-email-api.md) · [All operations](https://skmtc.dev/thrd/apis/thrd-agent-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thrd/apis/thrd-agent-email-api/revisions/d8a88129cd34?raw)