Skip to main content

SES Managed Email

Nova provisions assistant-owned email identities and inbound routes through Amazon SES and Nova-managed routing records.

What you get​

  • managed email address provision on assistant creation
  • suspend/reactivate with assistant state
  • cleanup on assistant deletion
  • dedicated assistant routes plus reply-token routes
  • SES outbound send with delivery/bounce correlation
  • SES inbound ingest through S3 + SQS into Nova

Required config​

  • MANAGED_EMAIL_ENABLED=true
  • MANAGED_EMAIL_PROVIDER=ses
  • MANAGED_EMAIL_DOMAIN
  • MANAGED_EMAIL_REPLY_DOMAIN
  • MANAGED_EMAIL_COMMAND_ADDRESS
  • AWS_REGION
  • AWS_SES_INBOUND_BUCKET
  • AWS_SES_INBOUND_QUEUE_URL
  • AWS_SES_EVENTS_QUEUE_URL
  • optional AWS_SES_CONFIGURATION_SET

Inbound/outbound behavior​

  • outgoing send: SES API
  • incoming receive: SES receipt rules store raw MIME in S3 and enqueue notifications in SQS
  • Nova polls SES inbound/events queues, resolves mailbox routes, and hands messages into the agent pipeline
  • reply handling uses Nova reply-token addresses on the configured reply domain

Supported address types​

  • command mailbox: nova@chroma.so
  • dedicated assistant mailbox: for example jeff@assist.chroma.so
  • reply route: for example reply+<token>@reply.chroma.so

Customer-owned email​

  • BYO SMTP is supported for outbound send-only
  • inbound for customer domains requires forwarding, delegated subdomain, or provider webhook delivery into Nova
  • generic IMAP polling is not part of the primary managed path