Create a mail server

POST 
/mailservers

Creates a mail server. Requires system-settings.fullaccess. If Enabled is true, SMTP is tested first; a failed test still creates the server with Enabled false. Enabling one server disables the others. Service users are rejected (GE-1014).

Request

Responses

200

Server was stored. server_id is the new id. Message notes a skipped enable when the SMTP test failed.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

400

Validation or authorization failure. Body is {"Message": " - "}. Codes: AUTH-1001, AUTH-1003, AUTH-1030 (missing system-settings.fullaccess), IPV-1002, GE-1014 (service user), IPV-1008 (missing or extra keys), IPV-1001 (empty value), IPV-1010 (UserName), IPV-1011 (Password, AccountEmail, or ServerName), IPV-1012 (Port), IPV-1013 (Enabled not bool), IPV-1020 (ServerDescription not a string), IPV-1018 (duplicate ServerName).

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers

500

DynamoDB create failure uses DB-1001. SSM credential store failure uses GE-1011. Other uncaught errors use {"Message": "GE-1008 - Could not complete the request. Please try again."}.

Response Headers

Access-Control-Allow-Origin
Access-Control-Allow-Methods
Access-Control-Allow-Headers