{"id":5490,"date":"2020-10-26T12:38:41","date_gmt":"2020-10-26T20:38:41","guid":{"rendered":"https:\/\/officedevblogs.wpengine.com\/?p=5490"},"modified":"2020-10-26T12:38:41","modified_gmt":"2020-10-26T20:38:41","slug":"mailbox-1-9-javascript-api-is-generally-available","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/mailbox-1-9-javascript-api-is-generally-available\/","title":{"rendered":"Mailbox 1.9 JavaScript API is Generally Available"},"content":{"rendered":"<p>Have you ever sent a mail, but forgot some essential disclaimer or text that needed to be in the message? With the append-on-send feature in the <a href=\"https:\/\/docs.microsoft.com\/office\/dev\/add-ins\/reference\/objectmodel\/requirement-set-1.9\/outlook-requirement-set-1.9\">Mailbox 1.9 API<\/a>, you\u2019ll never have to worry about this again. You can programmatically ensure that what needs to be in a message is included as the mail is sent. This could be plain text, or even HTML.<\/p>\n<p>Give it a try with <a href=\"https:\/\/docs.microsoft.com\/office\/dev\/add-ins\/outlook\/append-on-send\">our walkthrough<\/a>. We\u2019ve developed this feature based on your feedback, as this has been a top request from our community.<\/p>\n<p>Append on Send is just one of the great new features in the <a href=\"https:\/\/docs.microsoft.com\/office\/dev\/add-ins\/reference\/objectmodel\/requirement-set-1.9\/outlook-requirement-set-1.9\">Mailbox 1.9 API<\/a>, which is now generally available.<\/p>\n<p><strong>What are the new capabilities in 1.9?<\/strong><\/p>\n<p>The following features are included in this release. Be sure to watch <a href=\"https:\/\/www.youtube.com\/watch?v=ab2QrLNosdk\">this recorded community call session<\/a>, where we covered a summary of the release, <a href=\"https:\/\/www.youtube.com\/watch?v=VZD3bXLX1ts\">this one covering the Bidirectional Dialog<\/a>, and this one with the <a href=\"https:\/\/www.youtube.com\/watch?v=3FXjhkC7TOY\">Display Items APIs<\/a> if you\u2019d like to learn more.<\/p>\n<table width=\"620\">\n<tbody>\n<tr>\n<td width=\"250\"><strong>Feature Area<\/strong><\/td>\n<td width=\"450\"><strong>APIs<\/strong><\/td>\n<td width=\"450\"><strong>Description<\/strong><\/td>\n<\/tr>\n<tr>\n<td width=\"250\">Append on Send API<\/td>\n<td width=\"450\"><a href=\"https:\/\/docs.microsoft.com\/javascript\/api\/outlook\/office.body?view=outlook-js-1.9#appendonsendasync-data--options--callback-\">item.body.appendOnSendAsync<\/a><\/td>\n<td width=\"250\">Appends content upon send.<\/td>\n<\/tr>\n<tr>\n<td width=\"250\">Bidirectional Dialog API<\/td>\n<td width=\"450\"><a href=\"https:\/\/docs.microsoft.com\/javascript\/api\/office\/office.dialog?branch=master&amp;view=outlook-js-1.9#messagechild-message-\">dialog.messageChild(message: string)<\/a><\/td>\n<td width=\"250\">Enables bidirectional communication between the dialog and add-in task panes.<\/td>\n<\/tr>\n<tr>\n<td width=\"250\">Custom Properties<\/td>\n<td width=\"450\"><a href=\"https:\/\/docs.microsoft.com\/javascript\/api\/outlook\/office.customproperties?view=outlook-js-1.9#getall--\">customProperties.getAll()<\/a><\/td>\n<td width=\"250\">Convenience method to get all the custom properties of an item in a single call.<\/td>\n<\/tr>\n<tr>\n<td width=\"250\">Display Items API<\/td>\n<td width=\"450\"><a href=\"https:\/\/docs.microsoft.com\/javascript\/api\/outlook\/office.mailbox?view=outlook-js-1.9#displayappointmentformasync-itemid--options--callback-\">mailbox.displayAppointmentFormAsync<\/a><\/p>\n<p><a href=\"https:\/\/docs.microsoft.com\/javascript\/api\/outlook\/office.mailbox?view=outlook-js-1.9#displaymessageformasync-itemid--options--callback-\">mailbox.displayMessageFormAsync<\/a><\/p>\n<p><a href=\"https:\/\/docs.microsoft.com\/javascript\/api\/outlook\/office.mailbox?view=outlook-js-1.9#displaynewappointmentformasync-parameters--options--callback-\">mailbox.displayNewAppointmentAsync<\/a><\/p>\n<p><a href=\"https:\/\/docs.microsoft.com\/javascript\/api\/outlook\/office.mailbox?view=outlook-js-1.9#displaynewmessageformasync-parameters--options--callback-\">mailbox.displayNewMessageAsync<\/a><\/p>\n<p>item.displayReplyAllFormAsync: <a href=\"https:\/\/docs.microsoft.com\/javascript\/api\/outlook\/office.messageread?view=outlook-js-1.9#displayreplyallformasync-formdata--options--callback-\">message<\/a>, <a href=\"https:\/\/docs.microsoft.com\/javascript\/api\/outlook\/office.appointmentread?view=outlook-js-1.9#displayreplyallformasync-formdata--options--callback-\">appointment<\/a><\/p>\n<p>item.displayReplyFormAsync: <a href=\"https:\/\/docs.microsoft.com\/javascript\/api\/outlook\/office.messageread?view=outlook-js-1.9#displayreplyformasync-formdata--options--callback-\">message<\/a>, <a href=\"https:\/\/docs.microsoft.com\/javascript\/api\/outlook\/office.appointmentread?view=outlook-js-1.9#displayreplyformasync-formdata--options--callback-\">appointment<\/a><\/td>\n<td width=\"182\">New asynchronous versions of these APIs enable developers to validate if the items were displayed.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p><strong>Where is 1.9 supported?<\/strong><\/p>\n<p>1.9 is currently supported in:<\/p>\n<ul>\n<li>Outlook on the web.<\/li>\n<li>Outlook on Windows (starting with version 2008 (build 13127.20296)) in the <a href=\"https:\/\/docs.microsoft.com\/officeupdates\/update-history-microsoft365-apps-by-date\">monthly channel<\/a>.<\/li>\n<li>Outlook on Mac \u2013 support will follow soon.<\/li>\n<\/ul>\n<p>Check out our video of the <a href=\"https:\/\/www.youtube.com\/watch?v=E4fcnYDtHj4\">recent community call<\/a> where we discussed this feature.<\/p>\n<p><strong>Call in for the latest information<\/strong><\/p>\n<p>Be sure to sign up for <a href=\"https:\/\/developer.microsoft.com\/office\/events\/?filterBy=Community%20calls\">our regular Office Add-ins community calls<\/a>, which take place once a month and cover all things Office Add-ins. We frequently cover new features, show demos, and always try to answer your questions! It is a great way to interact with feature PMs. The next call is on Wednesday, November 11, 2020 from 08:00 AM &#8211; 09:00 AM (UTC-08:00) Pacific Time (US &amp; Canada). See you then!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Mailbox 1.9 JavaScript API is now generally available.  Mailbox 1.9 JavaScript API enables you to add an append-on-send feature in the Mailbox 1.9 API, ensuring a disclaimer or text that needed to be in the message is included. By using plain text, or even HTML, you can programmatically ensure your message is ready for sending.<\/p>\n","protected":false},"author":69076,"featured_media":25159,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[11],"tags":[28],"class_list":["post-5490","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-office-add-ins","tag-office-add-ins"],"acf":[],"blog_post_summary":"<p>Mailbox 1.9 JavaScript API is now generally available.  Mailbox 1.9 JavaScript API enables you to add an append-on-send feature in the Mailbox 1.9 API, ensuring a disclaimer or text that needed to be in the message is included. By using plain text, or even HTML, you can programmatically ensure your message is ready for sending.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/5490","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/users\/69076"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=5490"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/5490\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/25159"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=5490"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=5490"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=5490"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}