Recipient Object
Collapse the table of content
Expand the table of content

Recipient Object (Outlook)

Office 2013 and later

Contribute to this content

Use GitHub to suggest and submit changes. See our guidelines for contributing to VBA documentation.

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

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 e-mail address, or the mobile phone number of the recipient. A good practice is to use the SMTP e-mail 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.

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
© 2015 Microsoft