{"id":15925,"date":"2023-10-26T09:00:48","date_gmt":"2023-10-26T16:00:48","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/?p=15925"},"modified":"2023-10-26T09:13:42","modified_gmt":"2023-10-26T16:13:42","slug":"important-announcement-update-to-exchange-callback-tokens-for-outlook-add-ins","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/important-announcement-update-to-exchange-callback-tokens-for-outlook-add-ins\/","title":{"rendered":"Update to Exchange callback tokens for Outlook add-ins"},"content":{"rendered":"<p><span data-contrast=\"none\">Learn how to prepare for the upcoming change to Exchange callback tokens and avoid any disruptions in your Outlook add-ins.<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n<h2 aria-level=\"2\"><span data-contrast=\"none\">What is changing and why?<\/span><span data-ccp-props=\"{&quot;134245418&quot;:true,&quot;134245529&quot;:true,&quot;335559738&quot;:160,&quot;335559739&quot;:80}\">\u00a0<\/span><\/h2>\n<p><span data-contrast=\"auto\">We&#8217;re updating Exchange callback tokens used by Outlook add-ins to call REST APIs or Exchange Web Services (EWS). Specifically, these callback tokens are returned by the <\/span><a href=\"https:\/\/learn.microsoft.com\/javascript\/api\/outlook\/office.mailbox?view=outlook-js-preview#outlook-office-mailbox-getcallbacktokenasync-member(1)\"><span data-contrast=\"none\">getCallbackTokenAsync(options, callback)<\/span><\/a><span data-contrast=\"auto\"> and <\/span><a href=\"https:\/\/learn.microsoft.com\/en-us\/javascript\/api\/outlook\/office.mailbox?view=outlook-js-preview#outlook-office-mailbox-getcallbacktokenasync-member(2)\"><span data-contrast=\"none\">getCallbackTokenAsync(callback, userContext)<\/span><\/a><span data-contrast=\"auto\"> methods. The update is part of continual improvements to maintain a more secure environment for Exchange users and resources such as mailbox and calendar.<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">If your Outlook add-in doesn\u2019t rely on the token format, and it just uses the token to access Exchange resources, it will not be affected by this change. If your add-in parses the token, or relies on anything inside the token string, it might be impacted. <\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">The change will take effect on January 1, 2024. After that date, any Outlook add-ins that rely on the internal format of the token will be affected. It is important that you update your add-ins to avoid any dependency on the token format before that date.<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n<h2 aria-level=\"2\"><span data-contrast=\"none\">Recommended action<\/span><span data-ccp-props=\"{&quot;134245418&quot;:true,&quot;134245529&quot;:true,&quot;335559738&quot;:160,&quot;335559739&quot;:80}\">\u00a0<\/span><\/h2>\n<p><span data-contrast=\"auto\">The token format is opaque, and your Outlook add-in should not parse or rely on anything inside the token string. The format might change again in the future. We recommend that you check your Outlook add-in to make sure that it doesn&#8217;t parse or rely on the content of the token string.<\/span><span data-ccp-props=\"{}\">\u00a0<\/span><\/p>\n<p><span data-contrast=\"auto\">Thank you.<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Learn how to prepare for the upcoming change to Exchange callback tokens and avoid any disruptions in your Outlook add-ins.\u00a0<\/p>\n","protected":false},"author":133712,"featured_media":15931,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1,11],"tags":[69,28,12],"class_list":["post-15925","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-microsoft-365-developer","category-office-add-ins","tag-exchange","tag-office-add-ins","tag-outlook"],"acf":[],"blog_post_summary":"<p>Learn how to prepare for the upcoming change to Exchange callback tokens and avoid any disruptions in your Outlook add-ins.\u00a0<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/15925","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\/133712"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/comments?post=15925"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/posts\/15925\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media\/15931"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/media?parent=15925"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/categories?post=15925"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/microsoft365dev\/wp-json\/wp\/v2\/tags?post=15925"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}