Email - Configs
Email configuration management for tenant-specific SMTP or OAuth email providers. Provides CRUD operations for creating, retrieving, updating, and deleting email configurations. Supports multiple configurations per tenant with default/shared management, SMTP settings, and OAuth (Microsoft365/Google) flows. Includes a test endpoint to verify configurations.
-
GET List Email ConfigsReturns a paginated list of email configurations the current user can access (owned or shared)./tenants/{tenant}/email-configs
-
POST Create Email ConfigCreates a new email configuration. For SMTP: provide SmtpSettings. For OAuth (Microsoft365/Google): provide OAuthSettings with returnUrl - response in.../tenants/{tenant}/email-configs
-
GET Get Email ConfigReturns a single email configuration including provider details (SMTP settings, OAuth status). User must be the owner or the config must be shared./tenants/{tenant}/email-configs/{code}
-
PUT Update Email ConfigUpdates an existing email configuration. Supports updating provider settings (SmtpSettings), display name (FromName), and flags (IsDefault, IsShared)..../tenants/{tenant}/email-configs/{code}
-
DELETE Delete Email ConfigDeletes an email configuration. Cannot delete the tenant's default config unless it is the only one remaining. User must be the owner or the config mu.../tenants/{tenant}/email-configs/{code}
-
POST Test Email ConfigSends a test email using the specified configuration to verify it is working correctly. User must be the owner or the config must be shared./tenants/{tenant}/email-configs/{code}/test
-
POST Reconnect OAuth email configurationGenerates a fresh OAuth authorisation URL for reconnecting an expired or incorrectly-connected email configuration. Only works for OAuth providers (Mi.../tenants/{tenant}/email-configs/{code}/reconnect