Inbound Email

Receive and classify inbound email with intent detection, routing actions, and safety flags.

Molted Email can receive inbound email on your mailboxes, classify intent, and route messages to the right handler.

List inbound messages

GET https://api.molted.email/v1/inbound

curl

curl "https://api.molted.email/v1/inbound?tenantId=tenant_abc123" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

[
  {
    "id": "msg_abc123",
    "tenantId": "tenant_abc123",
    "fromEmail": "customer@example.com",
    "toEmail": "support@yourdomain.com",
    "subject": "Need help with billing",
    "bodyText": "I have a question about my invoice...",
    "classification": {
      "intent": "billing",
      "confidence": 0.92,
      "suggestedAction": "notify_owner"
    },
    "createdAt": "2026-03-01T12:00:00Z"
  }
]

Approve routing

For messages that require manual approval before being routed:

POST https://api.molted.email/v1/inbound/:id/approve

curl

curl -X POST https://api.molted.email/v1/inbound/msg_abc123/approve \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tenantId": "tenant_abc123",
    "action": "notify_owner"
  }'

Intent categories

When an inbound message is classified, it is assigned one of these intent categories:

Intent	Description
`interested`	Recipient expressed interest or wants to move forward.
`not_now`	Recipient is not interested at this time but may be later.
`objection`	Recipient raised a concern or objection.
`support`	Recipient needs help or has a support question.
`billing`	Recipient has a billing-related question or issue.
`legal`	Message relates to legal matters.
`security`	Message relates to a security concern.
`out_of_office`	Automated out-of-office reply.
`unclassified`	Could not determine a clear intent.

Each classification also includes a confidence score between 0 and 1, and a suggestedAction.

Routing actions

The classification engine suggests one of these routing actions:

Action	Description
`notify_owner`	Notify the contact's assigned owner.
`require_approval`	Hold the message until manually approved.
`auto_archive`	Archive the message automatically (e.g., out-of-office replies).
`escalate`	Escalate to a human reviewer for handling.

Safety flags

Messages may be flagged with safety indicators that require additional attention:

Flag	Description
`conflicting_intents`	Multiple intent signals detected — may need human review.
`low_confidence`	Classification confidence is below threshold — routing may be unreliable.