Test the settings of an incoming (IMAP or POP3) mail server. SysAid opens a connection to the server and authenticates with the given credentials. It saves nothing and reads no message. For IMAP, SysAid opens the INBOX read-write and closes it with an expunge, so messages in it that are already marked deleted are removed; for POP3 nothing in the mailbox changes. The settings are taken from the request only - this operation does not read or change any stored email integration, so the error counters and alerts of a stored integration are not reset by a successful test (no id is ever sent to SysAid). When the test ran, the answer is always 200 with success, a machine-readable reason and a fixed message; a failed test (wrong server, encryption or credentials, an unreachable server) is success false, not an error status. The message is one fixed text per reason and never contains the server, 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). timeout is reported for IMAP only, because SysAid reports every POP3 connection or read failure, a timeout included, as connection_failed (after about 10 seconds). SysAid waits up to 10 seconds for each step of the 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/incoming
