Send messages directly from your app, and save, update, and remove messages from different accounts on the device.

You can use the classes in this API to construct a message and send it. Messages can include information such as subject, body, sender, and recipients, and you can monitor the status of the message to determine if it was transmitted successfully. You can also create conversations with a list of participants and other information.

To use the messaging service, you must set the access_pimdomain_messages permission to access email and PIN messages and the access_sms_mms permission to access text messages. These permissions are set in the bar-descriptor.xml file of your project.

Additional resources

To learn more about the Messages API and how to use it in your apps, visit the Personal information management documentation.


  • Attachment -

    The Attachment class represents an attachment to a message.

  • AttachmentDownloadStatus -

    The AttachmentDownloadStatus class includes possible transmission statuses for attachments in messages.

  • AttachmentEncoding -

    The AttachmentEncoding class represents the encoding type of a message attachment.

  • AttachmentFilter -

    The AttachmentFilter class lets you filter lists of attachments based on key-value pairs.

  • Conversation -

    The Conversation class represents a conversation between message recipients.

  • ConversationBuilder -

    The ConversationBuilder class lets you create, and specify properties for, a new Conversation.

  • ConversationStatus -

    The ConversationStatus class includes possible statuses for conversations.

  • ConversationUpdate -

    The ConversationUpdate class represents updated information for a conversation.

  • FileAttachment -

    The FileAttachment class represents a file attachment.

  • Filter -

    The Filter class represents a filter in the Messages API.

  • Folder -

    The Folder class represents a folder in the Messages API.

  • FollowupFlag -

    The FollowupFlag class represents a follow-up flag in the Messages API.

  • MarkOrDeletePriorFilter -

    The MarkOrDeletePriorFilter class lets you specify options and parameters for prior options.

  • MarkOrDeletePriorOp -

    The MarkOrDeletePriorOp class includes Prior to Date operations for messages.

  • Message -

    The Message class represents information about a message, such as subject, sender and recipient contacts, and status.

  • MessageBody -

    The MessageBody class represents the body of a message.

  • MessageBuilder -

    The MessageBuilder class lets you create, and specify properties for, a new Message or edit an existing Message.

  • MessageClass -

    The MessageClass class includes possible class types for a message.

  • MessageContact -

    The MessageContact class represents a recipient or sender of a message.

  • MessageFilter -

    The MessageFilter class lets you filter lists of messages based on key-value pairs.

  • MessageFlag -

    The MessageFlag class represents the follow-up flag for a message.

  • MessageFolder -

    The MessageFolder class represents a folder to store messages.

  • MessagePriority -

    The MessagePriority class includes priority levels for messages.

  • MessageReplyState -

    The MessageReplyState class includes reply state levels for messages.

  • MessageRights -

    The MessageRights class represents the rights and permissions for a message.

  • MessageSearchFilter -

    The MessageSearchFilter class lets you specify search criteria for messages.

  • MessageService -

    The MessageService class provides access (read, write, and update) to PIM message data.

  • MessageServiceFeature -

    The MessageServiceFeature class includes message service features for an account.

  • MessageStatus -

    The MessageStatus class represents the status of a message.

  • MessageTransaction -

    The MessageTransaction class represents an action that can take place on a particular message in the message database.

  • MessageTransmissionStatus -

    The MessageTransmissionStatus class includes statuses for message transmission.

  • MessageUpdate -

    The MessageUpdate class represents a change or update to a message.

  • MessageUpdateFilter -

    The MessageUpdateFilter class lets you specify options and parameters for bulk options.

  • MimeTypes -

    The MimeTypes class includes constants that represent possible MIME types for messages.

  • OutOfOfficeSettings -

    The OutOfOfficeSettings class includes information about out-of-office replies for messages.

  • SearchFilterCriteria -

    The SearchFilterCriteria class includes possible search criteria that you can use to search for messages.

  • SearchStatusCriteria -

    The SearchStatusCriteria class includes possible statuses that you can use to search for messages.

  • SmsTransport -

    The SmsTransport class lets you perform operations on SMS messages from your apps.

  • SmsTransportRegistrationResult -

    The SmsTransportRegistrationResult class defines possible statuses for port registration requests for an SmsTransport.

  • SmsTransportSendResult -

    The SmsTransportSendResult class defines possible statuses for send requests for an SmsTransport.

  • StatusReport -

    The StatusReport class represents status information for a Message.

  • StatusReportType -

    The StatusReportType class includes possible status types for a message status report.

Last modified: 2014-11-17

Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus