Skip to content
UltimateTeam.ai Docs

Handle inbound email webhooks

POST
/api/v1/webhooks/email-inbound

Receives inbound email events from the email routing provider (Cloudflare Email Workers, Postmark, etc). Always returns 200 to prevent retries.

Authorizations

Request Body

Any of:

Inbound email webhook payload.

Attributes: from_address: Sender email address. to_address: Recipient address (agent mailbox). subject: Email subject line. body_text: Plain-text body. body_html: Optional HTML body. message_id: Email message-ID header. headers: Additional headers. attachments: Raw attachment dicts (filename, content_type, content).

object
attachments
Array<object>
object
key
additional properties
any
body_html
Any of:
string
body_text
Any of:
string
from
Any of:
string
headers
object
key
additional properties
any
message_id
Any of:
string
subject
Any of:
string
to
Any of:
string

Responses

200

Successful Response

Generic webhook acknowledgement response.

Attributes: received: Always True when the webhook was accepted. status: Optional status string (e.g. “duplicate” for idempotent replay).

object
received
boolean
default: true
status
Any of:
string

422

Validation Error

object
detail
Array<object>
object
ctx
object
input
loc
required
Array
msg
required
string
type
required
string