Edit

Recipient object (Outlook)

  • Article

Represents a user or resource in Outlook, generally a mail or mobile message addressee.

Remarks

Use the Recipients (index) method, where index is the name or index number, to return a single Recipient object. The name can be a string that represents the display name, the alias, the full SMTP email address, or the mobile phone number of the recipient. A good practice is to use the SMTP email address for a mail message, and the mobile phone number for a mobile message.

Use the Add method to create a new Recipient object and add it to the Recipients object.

The Type property of a new Recipient object is set to the default value for the associated AppointmentItem, JournalItem, MailItem, MeetingItem, or TaskItem object and must be reset to indicate another recipient type.

Example

The following Visual Basic for Applications (VBA) example creates a new MailItem object and adds Jon Grande as the recipient by using the default type ("To").

Set myItem = Application.CreateItem(olMailItem) 
 
Set myRecipient = myItem.Recipients.Add ("Jon Grande")

The following VBA example creates the same MailItem object as the preceding example, and then changes the type of the Recipient object from the default (To) to CC.

Set myItem = Application.CreateItem(olMailItem) 
 
Set myRecipient = myItem.Recipients.Add ("Jon Grande") 
 
myRecipient.Type = olCC

Methods

Name
Delete
FreeBusy
Resolve

Properties

Name
Address
AddressEntry
Application
AutoResponse
Class
DisplayType
EntryID
Index
MeetingResponseStatus
Name
Parent
PropertyAccessor
Resolved
Sendable
Session
TrackingStatus
TrackingStatusTime
Type

See also

Support and feedback

Have questions or feedback about Office VBA or this documentation? Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.