SMTP

Configure outbound email servers used when users send pictures by email or when MAIL-type EDI destinations deliver messages.

ConPDS operates platform (master) SMTP configurations. Tenants can add their own named configs and an outbound route (primary + optional fallback). When a tenant row is missing, the platform chain is used automatically.

What you can do

• Add SMTP configurations — each has a unique config key (e.g. MAIL, OPERATIONS)
• Set host, port, encryption, credentials — or Microsoft Graph fields when using Graph transport
• Configure sender name, reply-to, BCC per config
• Set primary and fallback on the outbound route panel
• Send test email — validates connectivity using the same chain as production sends
• Edit or delete existing configs

Platform defaults vs tenant configs

Layer	When used
Tenant SMTP list	Named rows you create under Admin → SMTP
Tenant outbound route	Primary config key, then optional fallback key
Platform (master) SMTP	Used when tenant has no matching row for a chain step
Platform route	Master primary, then master fallback

Gallery New mail and MAIL EDI destinations without SMTP_CONFIG_PICTURES follow the full chain below.

Send order

Outbound mail tries configs in this order (smtp_send_chain.py):

1. Tenant primary (from outbound route)
2. Tenant fallback (if configured on route)
3. Platform primary
4. Platform fallback

Each step is skipped when that phase has no resolvable config row. The first successful send wins; later steps are not tried.

EDI MAIL override

When a MAIL destination’s Params include:

SMTP_CONFIG_PICTURES=MY_CONFIG_KEY

only that single tenant SMTP config key is used for that destination. There is no route fallback and no platform chain for that send. If the key does not exist, the send fails.

Document all MAIL Params in EDI Params reference.

Common workflow

1. Review platform defaults — many tenants send successfully without custom SMTP
2. Add a tenant config — dedicated relay credentials from your IT team
3. Set outbound route — primary = production relay, fallback = backup relay
4. Send test email — confirm delivery and spam scoring (SPF/DKIM)
5. Reference in EDI — optional SMTP_CONFIG_PICTURES on MAIL destinations

Tips

• Verify SPF/DKIM with your IT team so inspection emails are not marked as spam
• Use a dedicated service account for SMTP authentication
• After changing SMTP, send a test from Admin and a sample Gallery email send

See also: Address Book, EDI Params — SMTP_CONFIG_PICTURES, Send to Destinations — Email