Contact object (JavaScript API for Office)

Office Add-ins

Represents a contact stored on the server.

Last modified: August 07, 2015

Note Note

The name "apps for Office" is changing to "Office Add-ins". During the transition, the documentation and the UI of some Office host applications and Visual Studio tools might still use the term "apps for Office". For details, see New name for apps for Office and SharePoint.

Hosts:Outlook

Add-in type: Mail

Available in requirement sets

Mailbox

Last changed in Mailbox

1.0

Applicable Outlook modes

Read

See all support details

contact

Properties

Property name

Outlook mode

Description

Introduced in

addresses

Read

Gets the mailing and street addresses associated with the contact.

Version 1.0

businessName

Read

Gets the name of the business associated with the contact.

Version 1.0

emailAddresses

Read

Gets the SMTP email addresses associated with the contact.

Version 1.0

personName

Read

Gets the name of the person associated with the contact.

Version 1.0

phoneNumbers

Read

Gets the phone numbers (work, home, cell) associated with the contact.

Version 1.0

urls

Read

Gets the Internet URLs associated with the contact.

Version 1.0

The list of contacts associated with an email message or calendar appointment is returned in the contacts property of the Entities object that is returned by the getEntities or getEntitiesByType method of the active item.

A checkmark (√) in the following table indicates that this property is supported in the corresponding Outlook host application. An empty cell indicates that the Outlook host application doesn't support this property.

For more information about Office host application and server requirements, see Requirements for running Office Add-ins.

Supported hosts, by platform

Office for Windows desktop

Office Online
(in browser)

OWA for Devices

Office for Mac

Outlook

√ (Read mode only)

Available in requirement sets

Mailbox

Minimum permission level

Restricted

Add-in types

Mail

Library

Office.js

Namespace

Office

Version

Changes

1.0

Introduced

Show:
© 2015 Microsoft