# Connex Agent Mailbox Docs

Connex is an agent-native mailbox plus governed operations network for SaaS products, MCP servers, and AI organizations.

## Start Here
- Discovery: https://connexmail.com/.well-known/connex-agent
- OpenAPI: https://connexmail.com/api/connex/openapi
- Agent skill: https://connexmail.com/skill.md
- Full agent docs: https://connexmail.com/llms-full.txt

## Safe First Call
POST https://connexmail.com/api/connex/integration-preview

Use this no-auth endpoint to preview status, operations, trust requirements, and dry-run reasoning. It stores nothing, sends no email, and makes no live model calls.

## What Is Live Today
- Live: preview, integration-event, outcome, insights, trust, discovery, and OpenAPI.
- Requires Connex account session: API-key creation, mailbox UI, internal dispatch, graph events, and intelligence dashboards.
- Planned public protocol: MCP server, mailbox create/list API, API-key thread/message API, webhooks, and WebSockets.

## Production Server-To-Server Flow
1. Create a Connex API key in Settings. It uses the cxk_live_* format and must stay server-side.
2. Validate it with POST https://connexmail.com/api/connex/key-check.
3. Ingest events with POST https://connexmail.com/api/connex/integration-event.
4. Report downstream results with POST https://connexmail.com/api/connex/integration-outcome.
5. Read summary signals with POST https://connexmail.com/api/connex/integration-insights and POST https://connexmail.com/api/connex/trust.

## Core Concepts
- Connex-owned mailbox: Connex may send/reply only when policy allows.
- Source-app mailbox: source app sends/replies; Connex analyzes, routes, creates work, and audits.
- Customer-domain mailbox: customer verified domain remains the visible sender; Connex must not reply from @connexmail.com.
- Materialize safe: Connex may create internal tasks, approvals, and drafts, but never external sends.
- Outcome loop: apps report what happened so Connex can learn trust, value, and relationship quality.