---
title: "Ingest an inbound email"
method: POST
path: "/v1/inbound"
tags: ["Inbound"]
---

# Ingest an inbound email

`POST /v1/inbound`

## Request

- Base URL: `https://api.volanea.com`
- URL: `https://api.volanea.com/v1/inbound`
- Auth: HTTP bearer

Store an inbound message, upsert the sender as a contact, and emit `email.received` (which fans out to webhooks and workflow triggers). Normally called by the SMTP relay's unauthenticated listener, but you can post parsed mail yourself.

## Request body

- object
  - `from` string, email, required
  - `fromName` string
  - `to` string, email, required
  - `subject` string
  - `html` string
  - `text` string

## Response `201`

Stored.

- object
  - `emailId` string, required: The stored email id.

## Other responses

- `401`: Missing or invalid API key.
- `422`: Request validation failed (code `validation_error`, 422).

---

[API](https://skmtc.dev/volanea/apis/volanea-api.md) · [All operations](https://skmtc.dev/volanea/apis/volanea-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volanea/apis/volanea-api/revisions/9e187ae84fda?raw)