{"id":7466,"date":"2020-11-17T15:49:27","date_gmt":"2020-11-17T20:49:27","guid":{"rendered":"https:\/\/knowlegebase-b5heb6b2esbghgd4.eastus2-01.azurewebsites.net\/?post_type=ht_kb&#038;p=7466"},"modified":"2025-04-15T17:46:21","modified_gmt":"2025-04-15T21:46:21","slug":"datamotion-api-faqs","status":"publish","type":"ht_kb","link":"https:\/\/knowlegebase-b5heb6b2esbghgd4.eastus2-01.azurewebsites.net\/?ht_kb=datamotion-api-faqs","title":{"rendered":"DataMotion API FAQs"},"content":{"rendered":"<span class=\"span-reading-time rt-reading-time\"><span class=\"rt-label rt-prefix\">Est. reading time:<\/span> <span class=\"rt-time\"> 2<\/span> <span class=\"rt-label rt-postfix\">minutes<\/span><\/span>\n\n\n\n<h2 class=\"wp-block-heading\">Questions and Answers Regarding DataMotion APIs<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\"><p id=\"DM-APIs\">DataMotion receives a number of questions regarding its <a href=\"#DM-APIs\">API<\/a>s mainly pertaining to how they function and what can be done to maximize their effectiveness for developers. These questions are highlighted as individual sections throughout this article which is updated over time whenever new questions are posed.<\/p><\/p>\n\n\n    \t\t<div class=\"hts-messages hts-messages--info  hts-messages--withtitle  \"   >\r\n    \t\t\t<span class=\"hts-messages__title\">Note<\/span>    \t\t\t    \t\t\t\t<p>\r\n    \t\t\t\t\tFor technical information regarding the API methods and their expected request formats see the <a href=\"https:\/\/developer-docs.datamotion.com\">DataMotion Developer Center<\/a>&nbsp;website.    \t\t\t\t<\/p>\r\n    \t\t\t    \t\t\t\r\n    \t\t<\/div><!-- \/.ht-shortcodes-messages -->\r\n    \t\t\n\n\n\n<h3 class=\"wp-block-heading\">How to retrieve the number of Unread Messages in an Inbox<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">In order to find the number of unread messages within an inbox you should use the <strong>GetMailboxXML<\/strong> method and set the <strong>GetInboxUnReadOnly&nbsp;<\/strong>flag to true.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Is there a way to search an Inbox with the API<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Yes it is possible to search an Inbox by using the <strong>GetMailboxXML<\/strong> and setting the <strong>Filter<\/strong> parameter.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Is there a method for adding signatures to messages<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The short answer is no such a method does not exist within the DataMotion Messaging API as of now. In order to do this currently, one would need to construct it themselves as part of the MIME message.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">How to return additional information when retrieving a message<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">While using the SOAP based DataMotion Messaging API it is possible to set additional headers which are &#8220;WithCMHeaderXML&#8221;, &#8220;WithTrackingXML&#8221;, and &#8220;WithSecurityEnvelope&#8221; to the request. The &#8220;WithCMHeaderXML&#8221; header in particular will return a X-CMHeaderXML field in the response containing useful information such as the message expiration date within the DateExpires section.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Questions and Answers Regarding DataMotion APIs DataMotion receives a number of questions regarding its APIs mainly pertaining to how they function and what can be done to maximize their effectiveness for developers. These questions are highlighted as individual sections throughout this article which is updated over time whenever new questions&#8230;<\/p>\n","protected":false},"author":1,"comment_status":"open","ping_status":"closed","template":"","format":"standard","meta":{"content-type":"","footnotes":""},"ht-kb-category":[181],"ht-kb-tag":[],"class_list":["post-7466","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-datamotion-apis"],"_links":{"self":[{"href":"https:\/\/knowlegebase-b5heb6b2esbghgd4.eastus2-01.azurewebsites.net\/index.php?rest_route=\/wp\/v2\/ht-kb\/7466","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/knowlegebase-b5heb6b2esbghgd4.eastus2-01.azurewebsites.net\/index.php?rest_route=\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/knowlegebase-b5heb6b2esbghgd4.eastus2-01.azurewebsites.net\/index.php?rest_route=\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/knowlegebase-b5heb6b2esbghgd4.eastus2-01.azurewebsites.net\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/knowlegebase-b5heb6b2esbghgd4.eastus2-01.azurewebsites.net\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=7466"}],"version-history":[{"count":4,"href":"https:\/\/knowlegebase-b5heb6b2esbghgd4.eastus2-01.azurewebsites.net\/index.php?rest_route=\/wp\/v2\/ht-kb\/7466\/revisions"}],"predecessor-version":[{"id":7891,"href":"https:\/\/knowlegebase-b5heb6b2esbghgd4.eastus2-01.azurewebsites.net\/index.php?rest_route=\/wp\/v2\/ht-kb\/7466\/revisions\/7891"}],"wp:attachment":[{"href":"https:\/\/knowlegebase-b5heb6b2esbghgd4.eastus2-01.azurewebsites.net\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=7466"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/knowlegebase-b5heb6b2esbghgd4.eastus2-01.azurewebsites.net\/index.php?rest_route=%2Fwp%2Fv2%2Fht-kb-category&post=7466"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/knowlegebase-b5heb6b2esbghgd4.eastus2-01.azurewebsites.net\/index.php?rest_route=%2Fwp%2Fv2%2Fht-kb-tag&post=7466"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}