Get Message Count

This Email tool returns the number of messages in a folder that match the given criteria.

Inputs

Folder ID 

The unique identifier for the folder being queried. This ID is retrieved with an Incoming Mail initiator, or the Open Folder tool.

Status

The status the message should be changed to. This parameter can have a value of either "read" or "unread."

Importance

Specifies the importance of the message as "Low," "Normal," or "High."

Sensitivity

This parameter is a string that can have the value of "None", "Personal", "Private", or "Confidential". The default is "None", and this will also be used in the event that something other than one of the other three valid values is entered.

Message Class

Only messages with this class will be searched, can be "text," "voice," "fax," or "ndr."

Subject

Only messages with this subject will be searched. Uses a regular expression.

Sender

Only messages from this sender will be searched (friendly name or email address). Uses a regular expression.

Start Date/Time

Only message received after this date and time will be searched.

End Date/Time 

Only messages received before this date and time will be searched.

Timeout

The number of seconds the tool should wait for a return value. If no value is returned in the specified time, this tool will take the Failure exit path.

Outputs

Unread Count

The number of unread messages that match.

Read Count

The number of read messages that match.

Result

The results of the operation.

See Email Tool Result Codes for more information.

Exit Paths

Success

This path is taken if the message count is successfully retrieved.

Failure

This path is taken if the operation fails.