Skip to content

Commit 4ee845a

Browse files
[Outlook] (mobile) Update supported Office.Recipients methods (#5273)
* Remove methods from unsupported APIs table * Add note about API support in quick reply mode * Document version number and update ms.date * Add missing word
1 parent 79d1b52 commit 4ee845a

File tree

2 files changed

+16
-4
lines changed

2 files changed

+16
-4
lines changed

docs/outlook/get-set-or-add-recipients.md

Lines changed: 15 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Get, set, or add recipients when composing an appointment or message in Outlook
33
description: Learn how to get, set, or add recipients to a message or appointment in an Outlook add-in.
4-
ms.date: 02/29/2024
4+
ms.date: 08/06/2025
55
ms.topic: how-to
66
ms.localizationpriority: medium
77
---
@@ -139,6 +139,13 @@ When calling `setAsync`, provide an array as the input argument for the `recipie
139139

140140
You can optionally provide a callback function as an input argument to the `setAsync` method, to make sure any code that depends on successfully setting the recipients would execute only when that happens. If you implement a callback function, use the `status` and `error` properties of the `asyncResult` output parameter to check the status and any error messages of the asynchronous call. To provide additional information to the callback function, use the optional `asyncContext` parameter in the `setAsync` call.
141141

142+
> [!NOTE]
143+
>
144+
> In Outlook on mobile devices, be mindful of the following:
145+
>
146+
> - The `addAsync` method is supported starting in Version 4.2530.0.
147+
> - The `addAsync` method isn't supported when a user replies from the reply field at the bottom of a message.
148+
142149
```js
143150
let item;
144151

@@ -233,6 +240,13 @@ function setRecipients() {
233240

234241
If you don't want to overwrite any existing recipients in an appointment or message, instead of using `Recipients.setAsync`, use the `Recipients.addAsync` asynchronous method to append recipients. `addAsync` works similarly as `setAsync` in that it requires a `recipients` input argument. You can optionally provide a callback function, and any arguments for the callback using the `asyncContext` parameter. Then, check the status, result, and any error of the asynchronous `addAsync` call using the `asyncResult` output parameter of the callback function. The following example checks if the item being composed is an appointment, then appends two required attendees to it.
235242

243+
> [!NOTE]
244+
>
245+
> In Outlook on mobile devices, be mindful of the following:
246+
>
247+
> - The `addAsync` method is supported starting in Version 4.2530.0.
248+
> - The `addAsync` method isn't supported when a user replies from the reply field at the bottom of a message.
249+
236250
```js
237251
let item;
238252

docs/outlook/outlook-mobile-apis.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: Outlook JavaScript APIs supported in Outlook on mobile devices
33
description: Learn which Outlook JavaScript APIs are supported in Outlook on mobile devices.
4-
ms.date: 06/12/2025
4+
ms.date: 08/06/2025
55
ms.localizationpriority: medium
66
---
77

@@ -62,8 +62,6 @@ Although Outlook mobile supports up to requirement set 1.5, there are some APIs
6262
|[Office.context.mailbox.item.getRegexMatches](/javascript/api/requirement-sets/outlook/preview-requirement-set/office.context.mailbox.item#methods)|Mailbox 1.1|<ul><li>Message Read</li><li>Appointment Attendee</li></ul>|
6363
|[Office.context.mailbox.item.getRegexMatchesByName](/javascript/api/requirement-sets/outlook/preview-requirement-set/office.context.mailbox.item#methods)|Mailbox 1.1|<ul><li>Message Read</li><li>Appointment Attendee</li></ul>|
6464
|[Office.context.mailbox.item.notificationMessages](/javascript/api/requirement-sets/outlook/preview-requirement-set/office.context.mailbox.item#methods)|Mailbox 1.3|<ul><li>Appointment Attendee</li><li>Appointment Organizer</li></ul>|
65-
|[Office.context.mailbox.item.bcc.addAsync](/javascript/api/outlook/office.recipients#outlook-office-recipients-addasync-member(1))<br><br>[Office.context.mailbox.item.cc.addAsync](/javascript/api/outlook/office.recipients#outlook-office-recipients-addasync-member(1))<br><br>[Office.context.mailbox.item.to.addAsync](/javascript/api/outlook/office.recipients#outlook-office-recipients-addasync-member(1))|Mailbox 1.1|<ul><li>Message Compose</li></ul>|
66-
|[Office.context.mailbox.item.bcc.setAsync](/javascript/api/outlook/office.recipients#outlook-office-recipients-setasync-member(1))<br><br>[Office.context.mailbox.item.cc.setAsync](/javascript/api/outlook/office.recipients#outlook-office-recipients-setasync-member(1))<br><br>[Office.context.mailbox.item.to.setAsync](/javascript/api/outlook/office.recipients#outlook-office-recipients-setasync-member(1))|Mailbox 1.1|<ul><li>Message Compose</li></ul>|
6765
|[Office.context.mailbox.item.body.getTypeAsync](/javascript/api/outlook/office.body#outlook-office-body-gettypeasync-member(1))|Mailbox 1.1|<ul><li>Message Compose</li></ul>|
6866
|[Office.context.mailbox.item.body.prependAsync](/javascript/api/outlook/office.body#outlook-office-body-prependasync-member(1))|Mailbox 1.1|<ul><li>Message Compose</li></ul>|
6967
|[Office.context.mailbox.item.body.setAsync](/javascript/api/outlook/office.body#outlook-office-body-setasync-member(1))|Mailbox 1.1|<ul><li>Message Compose</li></ul>|

0 commit comments

Comments
 (0)