This documentation is archived and is not being maintained.

Recipients.Add Method

Office 2007
Creates a new recipient in the Recipients collection.



expression   A variable that represents a Recipients object.


NameRequired/OptionalData TypeDescription
NameRequiredStringThe name of the recipient; it can be a string representing the display name, the alias, or the full SMTP e-mail address of the recipient.

Return Value
A Recipient object that represents the new recipient.


This VBA example creates a new mail message, uses the Add method to add 'Dan Wilson' as a To recipient, and displays the message. To run this example without errors, replace 'Dan Wilson' with a valid recipient name.

Visual Basic for Applications
Sub CreateStatusReportToBoss()
    Dim myItem As Outlook.MailItem
    Dim myRecipient As Outlook.Recipient

    Set myItem = Application.CreateItem(olMailItem)
    Set myRecipient = myItem.Recipients.Add("Dan Wilson")
    myItem.Subject = "Status Report"
End Sub