Test the settings of an outgoing (SMTP) mail server. SysAid opens a connection to the server and authenticates with the given credentials; it sends no email and saves nothing. The settings are taken from the request only - this operation does not read or change any stored email integration, so the failure counters of a stored integration are not reset by a successful test. When the test ran, the answer is always 200 with success, a machine-readable reason and a fixed message; a failed test (wrong host, port, encryption or credentials, a malformed emailAddress, an unreachable server) is success false, not an error status. The message is one fixed text per reason and never contains the host, the port, the submitted credentials or any text of the mail server. Whether the test passed is decided by SysAid's HTTP status, not by the language of its text; reason is refined only when the SysAid user speaks English, so for any other language a failed test has the reason unknown (a passed test is always success true). SysAid waits up to 10 seconds for each step of the SMTP exchange (connecting, then every reply), not for the test as a whole; the gateway gives up on the whole call after 40 seconds and answers 504, and SysAid may still be running the test then. A password that starts with crypt: and the placeholder ******** are rejected with 400, because neither is a password to try. The password is never logged. Requires a SysAid Admin session; SysAid administrators only. A request without a valid session is answered 401, and a signed-in user who is not a SysAid administrator is answered 403. Any other SysAid failure (the test could not be run) is answered 500, 502 or 504.
post
https://{account}.sysaidit.com/connect/v1/email-integrations/test/outgoing
