Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All

Contact object (JavaScript API for Office)

Office Add-ins

Represents a contact stored on the server.

Last modified: July 06, 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

App 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 apps for Office.

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

App types

Mail

Library

Office.js

Namespace

Office

Version

Changes

1.0

Introduced

Show:
© 2015 Microsoft