contact EntityType

Person with whom a business unit has a relationship, such as customer, supplier, and colleague.

Entity Set Path
[organization URI]/api/data/v9.0/contacts
Base Type
crmbaseentity
Display Name
Contact
Primary Key
contactid
Primary Key Attribute
fullname
Operations Supported
POST GET PATCH DELETE

Properties

Properties represent fields of data stored in the entity.Some properties are read-only.

Name Type Details
accountrolecode Edm.Int32

Select the contact's role within the company or sales process, such as decision maker, employee, or influencer.

Display Name: Role

Default Options
Value Label
1 Decision Maker
2 Employee
3 Influencer
address1_addressid Edm.Guid

Unique identifier for address 1.

Display Name: Address 1: ID

address1_addresstypecode Edm.Int32

Select the primary address type.

Display Name: Address 1: Address Type

Default Options
Value Label
1 Bill To
2 Ship To
3 Primary
4 Other
address1_city Edm.String

Type the city for the primary address.

Display Name: Address 1: City

address1_composite Edm.String

Shows the complete primary address.

Display Name: Address 1

Read Only
address1_country Edm.String

Type the country or region for the primary address.

Display Name: Address 1: Country/Region

address1_county Edm.String

Type the county for the primary address.

Display Name: Address 1: County

address1_fax Edm.String

Type the fax number associated with the primary address.

Display Name: Address 1: Fax

address1_freighttermscode Edm.Int32

Select the freight terms for the primary address to make sure shipping orders are processed correctly.

Display Name: Address 1: Freight Terms

Default Options
Value Label
1 FOB
2 No Charge
address1_latitude Edm.Double

Type the latitude value for the primary address for use in mapping and other applications.

Display Name: Address 1: Latitude

address1_line1 Edm.String

Type the first line of the primary address.

Display Name: Address 1: Street 1

address1_line2 Edm.String

Type the second line of the primary address.

Display Name: Address 1: Street 2

address1_line3 Edm.String

Type the third line of the primary address.

Display Name: Address 1: Street 3

address1_longitude Edm.Double

Type the longitude value for the primary address for use in mapping and other applications.

Display Name: Address 1: Longitude

address1_name Edm.String

Type a descriptive name for the primary address, such as Corporate Headquarters.

Display Name: Address 1: Name

address1_postalcode Edm.String

Type the ZIP Code or postal code for the primary address.

Display Name: Address 1: ZIP/Postal Code

address1_postofficebox Edm.String

Type the post office box number of the primary address.

Display Name: Address 1: Post Office Box

address1_primarycontactname Edm.String

Type the name of the main contact at the account's primary address.

Display Name: Address 1: Primary Contact Name

address1_shippingmethodcode Edm.Int32

Select a shipping method for deliveries sent to this address.

Display Name: Address 1: Shipping Method

Default Options
Value Label
1 Airborne
2 DHL
3 FedEx
4 UPS
5 Postal Mail
6 Full Load
7 Will Call
address1_stateorprovince Edm.String

Type the state or province of the primary address.

Display Name: Address 1: State/Province

address1_telephone1 Edm.String

Type the main phone number associated with the primary address.

Display Name: Address 1: Phone

address1_telephone2 Edm.String

Type a second phone number associated with the primary address.

Display Name: Address 1: Telephone 2

address1_telephone3 Edm.String

Type a third phone number associated with the primary address.

Display Name: Address 1: Telephone 3

address1_upszone Edm.String

Type the UPS zone of the primary address to make sure shipping charges are calculated correctly and deliveries are made promptly, if shipped by UPS.

Display Name: Address 1: UPS Zone

address1_utcoffset Edm.Int32

Select the time zone, or UTC offset, for this address so that other people can reference it when they contact someone at this address.

Display Name: Address 1: UTC Offset

address2_addressid Edm.Guid

Unique identifier for address 2.

Display Name: Address 2: ID

address2_addresstypecode Edm.Int32

Select the secondary address type.

Display Name: Address 2: Address Type

Default Options
Value Label
1 Default Value
address2_city Edm.String

Type the city for the secondary address.

Display Name: Address 2: City

address2_composite Edm.String

Shows the complete secondary address.

Display Name: Address 2

Read Only
address2_country Edm.String

Type the country or region for the secondary address.

Display Name: Address 2: Country/Region

address2_county Edm.String

Type the county for the secondary address.

Display Name: Address 2: County

address2_fax Edm.String

Type the fax number associated with the secondary address.

Display Name: Address 2: Fax

address2_freighttermscode Edm.Int32

Select the freight terms for the secondary address to make sure shipping orders are processed correctly.

Display Name: Address 2: Freight Terms

Default Options
Value Label
1 Default Value
address2_latitude Edm.Double

Type the latitude value for the secondary address for use in mapping and other applications.

Display Name: Address 2: Latitude

address2_line1 Edm.String

Type the first line of the secondary address.

Display Name: Address 2: Street 1

address2_line2 Edm.String

Type the second line of the secondary address.

Display Name: Address 2: Street 2

address2_line3 Edm.String

Type the third line of the secondary address.

Display Name: Address 2: Street 3

address2_longitude Edm.Double

Type the longitude value for the secondary address for use in mapping and other applications.

Display Name: Address 2: Longitude

address2_name Edm.String

Type a descriptive name for the secondary address, such as Corporate Headquarters.

Display Name: Address 2: Name

address2_postalcode Edm.String

Type the ZIP Code or postal code for the secondary address.

Display Name: Address 2: ZIP/Postal Code

address2_postofficebox Edm.String

Type the post office box number of the secondary address.

Display Name: Address 2: Post Office Box

address2_primarycontactname Edm.String

Type the name of the main contact at the account's secondary address.

Display Name: Address 2: Primary Contact Name

address2_shippingmethodcode Edm.Int32

Select a shipping method for deliveries sent to this address.

Display Name: Address 2: Shipping Method

Default Options
Value Label
1 Default Value
address2_stateorprovince Edm.String

Type the state or province of the secondary address.

Display Name: Address 2: State/Province

address2_telephone1 Edm.String

Type the main phone number associated with the secondary address.

Display Name: Address 2: Telephone 1

address2_telephone2 Edm.String

Type a second phone number associated with the secondary address.

Display Name: Address 2: Telephone 2

address2_telephone3 Edm.String

Type a third phone number associated with the secondary address.

Display Name: Address 2: Telephone 3

address2_upszone Edm.String

Type the UPS zone of the secondary address to make sure shipping charges are calculated correctly and deliveries are made promptly, if shipped by UPS.

Display Name: Address 2: UPS Zone

address2_utcoffset Edm.Int32

Select the time zone, or UTC offset, for this address so that other people can reference it when they contact someone at this address.

Display Name: Address 2: UTC Offset

address3_addressid Edm.Guid

Unique identifier for address 3.

Display Name: Address 3: ID

address3_addresstypecode Edm.Int32

Select the third address type.

Display Name: Address 3: Address Type

Default Options
Value Label
1 Default Value
address3_city Edm.String

Type the city for the 3rd address.

Display Name: Address 3: City

address3_composite Edm.String

Shows the complete third address.

Display Name: Address 3

Read Only
address3_country Edm.String

the country or region for the 3rd address.

Display Name: Address3: Country/Region

address3_county Edm.String

Type the county for the third address.

Display Name: Address 3: County

address3_fax Edm.String

Type the fax number associated with the third address.

Display Name: Address 3: Fax

address3_freighttermscode Edm.Int32

Select the freight terms for the third address to make sure shipping orders are processed correctly.

Display Name: Address 3: Freight Terms

Default Options
Value Label
1 Default Value
address3_latitude Edm.Double

Type the latitude value for the third address for use in mapping and other applications.

Display Name: Address 3: Latitude

address3_line1 Edm.String

the first line of the 3rd address.

Display Name: Address3: Street 1

address3_line2 Edm.String

the second line of the 3rd address.

Display Name: Address3: Street 2

address3_line3 Edm.String

the third line of the 3rd address.

Display Name: Address3: Street 3

address3_longitude Edm.Double

Type the longitude value for the third address for use in mapping and other applications.

Display Name: Address 3: Longitude

address3_name Edm.String

Type a descriptive name for the third address, such as Corporate Headquarters.

Display Name: Address 3: Name

address3_postalcode Edm.String

the ZIP Code or postal code for the 3rd address.

Display Name: Address3: ZIP/Postal Code

address3_postofficebox Edm.String

the post office box number of the 3rd address.

Display Name: Address 3: Post Office Box

address3_primarycontactname Edm.String

Type the name of the main contact at the account's third address.

Display Name: Address 3: Primary Contact Name

address3_shippingmethodcode Edm.Int32

Select a shipping method for deliveries sent to this address.

Display Name: Address 3: Shipping Method

Default Options
Value Label
1 Default Value
address3_stateorprovince Edm.String

the state or province of the third address.

Display Name: Address3: State/Province

address3_telephone1 Edm.String

Type the main phone number associated with the third address.

Display Name: Address 3: Telephone1

address3_telephone2 Edm.String

Type a second phone number associated with the third address.

Display Name: Address 3: Telephone2

address3_telephone3 Edm.String

Type a third phone number associated with the primary address.

Display Name: Address 3: Telephone3

address3_upszone Edm.String

Type the UPS zone of the third address to make sure shipping charges are calculated correctly and deliveries are made promptly, if shipped by UPS.

Display Name: Address 3: UPS Zone

address3_utcoffset Edm.Int32

Select the time zone, or UTC offset, for this address so that other people can reference it when they contact someone at this address.

Display Name: Address 3: UTC Offset

aging30 Edm.Decimal

For system use only.

Display Name: Aging 30

Read Only
aging30_base Edm.Decimal

Shows the Aging 30 field converted to the system's default base currency. The calculations use the exchange rate specified in the Currencies area.

Display Name: Aging 30 (Base)

Read Only
aging60 Edm.Decimal

For system use only.

Display Name: Aging 60

Read Only
aging60_base Edm.Decimal

Shows the Aging 60 field converted to the system's default base currency. The calculations use the exchange rate specified in the Currencies area.

Display Name: Aging 60 (Base)

Read Only
aging90 Edm.Decimal

For system use only.

Display Name: Aging 90

Read Only
aging90_base Edm.Decimal

Shows the Aging 90 field converted to the system's default base currency. The calculations use the exchange rate specified in the Currencies area.

Display Name: Aging 90 (Base)

Read Only
anniversary Edm.Date

Enter the date of the contact's wedding or service anniversary for use in customer gift programs or other communications.

Display Name: Anniversary

annualincome Edm.Decimal

Type the contact's annual income for use in profiling and financial analysis.

Display Name: Annual Income

annualincome_base Edm.Decimal

Shows the Annual Income field converted to the system's default base currency. The calculations use the exchange rate specified in the Currencies area.

Display Name: Annual Income (Base)

Read Only
assistantname Edm.String

Type the name of the contact's assistant.

Display Name: Assistant

assistantphone Edm.String

Type the phone number for the contact's assistant.

Display Name: Assistant Phone

birthdate Edm.Date

Enter the contact's birthday for use in customer gift programs or other communications.

Display Name: Birthday

business2 Edm.String

Type a second business phone number for this contact.

Display Name: Business Phone 2

callback Edm.String

Type a callback phone number for this contact.

Display Name: Callback Number

childrensnames Edm.String

Type the names of the contact's children for reference in communications and client programs.

Display Name: Children's Names

company Edm.String

Type the company phone of the contact.

Display Name: Company Phone

contactid Edm.Guid

Unique identifier of the contact.

Display Name: Contact

createdon Edm.DateTimeOffset

Shows the date and time when the record was created. The date and time are displayed in the time zone selected in Microsoft Dynamics 365 options.

Display Name: Created On

Read Only
creditlimit Edm.Decimal

Type the credit limit of the contact for reference when you address invoice and accounting issues with the customer.

Display Name: Credit Limit

creditlimit_base Edm.Decimal

Shows the Credit Limit field converted to the system's default base currency for reporting purposes. The calculations use the exchange rate specified in the Currencies area.

Display Name: Credit Limit (Base)

Read Only
creditonhold Edm.Boolean

Select whether the contact is on a credit hold, for reference when addressing invoice and accounting issues.

Display Name: Credit Hold

Default Options
Value Label
1 Yes
0 No
customersizecode Edm.Int32

Select the size of the contact's company for segmentation and reporting purposes.

Display Name: Customer Size

Default Options
Value Label
1 Default Value
customertypecode Edm.Int32

Select the category that best describes the relationship between the contact and your organization.

Display Name: Relationship Type

Default Options
Value Label
1 Default Value
department Edm.String

Type the department or business unit where the contact works in the parent company or business.

Display Name: Department

description Edm.String

Type additional information to describe the contact, such as an excerpt from the company's website.

Display Name: Description

donotbulkemail Edm.Boolean

Select whether the contact accepts bulk email sent through marketing campaigns or quick campaigns. If Do Not Allow is selected, the contact can be added to marketing lists, but will be excluded from the email.

Display Name: Do not allow Bulk Emails

Default Options
Value Label
1 Do Not Allow
0 Allow
donotbulkpostalmail Edm.Boolean

Select whether the contact accepts bulk postal mail sent through marketing campaigns or quick campaigns. If Do Not Allow is selected, the contact can be added to marketing lists, but will be excluded from the letters.

Display Name: Do not allow Bulk Mails

Default Options
Value Label
1 Yes
0 No
donotemail Edm.Boolean

Select whether the contact allows direct email sent from Microsoft Dynamics 365. If Do Not Allow is selected, Microsoft Dynamics 365 will not send the email.

Display Name: Do not allow Emails

Default Options
Value Label
1 Do Not Allow
0 Allow
donotfax Edm.Boolean

Select whether the contact allows faxes. If Do Not Allow is selected, the contact will be excluded from any fax activities distributed in marketing campaigns.

Display Name: Do not allow Faxes

Default Options
Value Label
1 Do Not Allow
0 Allow
donotphone Edm.Boolean

Select whether the contact accepts phone calls. If Do Not Allow is selected, the contact will be excluded from any phone call activities distributed in marketing campaigns.

Display Name: Do not allow Phone Calls

Default Options
Value Label
1 Do Not Allow
0 Allow
donotpostalmail Edm.Boolean

Select whether the contact allows direct mail. If Do Not Allow is selected, the contact will be excluded from letter activities distributed in marketing campaigns.

Display Name: Do not allow Mails

Default Options
Value Label
1 Do Not Allow
0 Allow
donotsendmm Edm.Boolean

Select whether the contact accepts marketing materials, such as brochures or catalogs. Contacts that opt out can be excluded from marketing initiatives.

Display Name: Send Marketing Materials

Default Options
Value Label
1 Do Not Send
0 Send
educationcode Edm.Int32

Select the contact's highest level of education for use in segmentation and analysis.

Display Name: Education

Default Options
Value Label
1 Default Value
emailaddress1 Edm.String

Type the primary email address for the contact.

Display Name: Email

emailaddress2 Edm.String

Type the secondary email address for the contact.

Display Name: Email Address 2

emailaddress3 Edm.String

Type an alternate email address for the contact.

Display Name: Email Address 3

employeeid Edm.String

Type the employee ID or number for the contact for reference in orders, service cases, or other communications with the contact's organization.

Display Name: Employee

entityimage Edm.Binary

Shows the default image for the record.

Display Name: Entity Image

entityimage_timestamp Edm.Int64
Read Only
entityimage_url Edm.String
Read Only
entityimageid Edm.Guid

For internal use only.

Display Name: Entity Image Id

Read Only
exchangerate Edm.Decimal

Shows the conversion rate of the record's currency. The exchange rate is used to convert all money fields in the record from the local currency to the system's default currency.

Display Name: Exchange Rate

Read Only
externaluseridentifier Edm.String

Identifier for an external user.

Display Name: External User Identifier

familystatuscode Edm.Int32

Select the marital status of the contact for reference in follow-up phone calls and other communications.

Display Name: Marital Status

Default Options
Value Label
1 Single
2 Married
3 Divorced
4 Widowed
fax Edm.String

Type the fax number for the contact.

Display Name: Fax

firstname Edm.String

Type the contact's first name to make sure the contact is addressed correctly in sales calls, email, and marketing campaigns.

Display Name: First Name

followemail Edm.Boolean

Information about whether to allow following email activity like opens, attachment views and link clicks for emails sent to the contact.

Display Name: Follow Email Activity

Default Options
Value Label
1 Allow
0 Do Not Allow
ftpsiteurl Edm.String

Type the URL for the contact's FTP site to enable users to access data and share documents.

Display Name: FTP Site

fullname Edm.String

Combines and shows the contact's first and last names so that the full name can be displayed in views and reports.

Display Name: Full Name

Read Only
gendercode Edm.Int32

Select the contact's gender to make sure the contact is addressed correctly in sales calls, email, and marketing campaigns.

Display Name: Gender

Default Options
Value Label
1 Male
2 Female
governmentid Edm.String

Type the passport number or other government ID for the contact for use in documents or reports.

Display Name: Government

haschildrencode Edm.Int32

Select whether the contact has any children for reference in follow-up phone calls and other communications.

Display Name: Has Children

Default Options
Value Label
1 Default Value
home2 Edm.String

Type a second home phone number for this contact.

Display Name: Home Phone 2

importsequencenumber Edm.Int32

Unique identifier of the data import or data migration that created this record.

Display Name: Import Sequence Number

isbackofficecustomer Edm.Boolean

Select whether the contact exists in a separate accounting or other system, such as Microsoft Dynamics GP or another ERP database, for use in integration processes.

Display Name: Back Office Customer

Default Options
Value Label
1 Yes
0 No
jobtitle Edm.String

Type the job title of the contact to make sure the contact is addressed correctly in sales calls, email, and marketing campaigns.

Display Name: Job Title

lastname Edm.String

Type the contact's last name to make sure the contact is addressed correctly in sales calls, email, and marketing campaigns.

Display Name: Last Name

lastonholdtime Edm.DateTimeOffset

Contains the date and time stamp of the last on hold time.

Display Name: Last On Hold Time

lastusedincampaign Edm.DateTimeOffset

Shows the date when the contact was last included in a marketing campaign or quick campaign.

Display Name: Last Date Included in Campaign

leadsourcecode Edm.Int32

Select the primary marketing source that directed the contact to your organization.

Display Name: Lead Source

Default Options
Value Label
1 Default Value
managername Edm.String

Type the name of the contact's manager for use in escalating issues or other follow-up communications with the contact.

Display Name: Manager

managerphone Edm.String

Type the phone number for the contact's manager.

Display Name: Manager Phone

marketingonly Edm.Boolean

Whether is only for marketing

Display Name: Marketing Only

Default Options
Value Label
1 Yes
0 No
merged Edm.Boolean

Shows whether the account has been merged with a master contact.

Display Name: Merged

Read Only
Default Options
Value Label
1 Yes
0 No
middlename Edm.String

Type the contact's middle name or initial to make sure the contact is addressed correctly.

Display Name: Middle Name

mobilephone Edm.String

Type the mobile phone number for the contact.

Display Name: Mobile Phone

modifiedon Edm.DateTimeOffset

Shows the date and time when the record was last updated. The date and time are displayed in the time zone selected in Microsoft Dynamics 365 options.

Display Name: Modified On

Read Only
nickname Edm.String

Type the contact's nickname.

Display Name: Nickname

numberofchildren Edm.Int32

Type the number of children the contact has for reference in follow-up phone calls and other communications.

Display Name: No. of Children

onholdtime Edm.Int32

Shows how long, in minutes, that the record was on hold.

Display Name: On Hold Time (Minutes)

Read Only
overriddencreatedon Edm.DateTimeOffset

Date and time that the record was migrated.

Display Name: Record Created On

pager Edm.String

Type the pager number for the contact.

Display Name: Pager

participatesinworkflow Edm.Boolean

Shows whether the contact participates in workflow rules.

Display Name: Participates in Workflow

Default Options
Value Label
1 Yes
0 No
paymenttermscode Edm.Int32

Select the payment terms to indicate when the customer needs to pay the total amount.

Display Name: Payment Terms

Default Options
Value Label
1 Net 30
2 2% 10, Net 30
3 Net 45
4 Net 60
preferredappointmentdaycode Edm.Int32

Select the preferred day of the week for service appointments.

Display Name: Preferred Day

Default Options
Value Label
0 Sunday
1 Monday
2 Tuesday
3 Wednesday
4 Thursday
5 Friday
6 Saturday
preferredappointmenttimecode Edm.Int32

Select the preferred time of day for service appointments.

Display Name: Preferred Time

Default Options
Value Label
1 Morning
2 Afternoon
3 Evening
preferredcontactmethodcode Edm.Int32

Select the preferred method of contact.

Display Name: Preferred Method of Contact

Default Options
Value Label
1 Any
2 Email
3 Phone
4 Fax
5 Mail
processid Edm.Guid

Shows the ID of the process.

Display Name: Process

salutation Edm.String

Type the salutation of the contact to make sure the contact is addressed correctly in sales calls, email messages, and marketing campaigns.

Display Name: Salutation

shippingmethodcode Edm.Int32

Select a shipping method for deliveries sent to this address.

Display Name: Shipping Method

Default Options
Value Label
1 Default Value
spousesname Edm.String

Type the name of the contact's spouse or partner for reference during calls, events, or other communications with the contact.

Display Name: Spouse/Partner Name

stageid Edm.Guid

Shows the ID of the stage.

Display Name: Process Stage

statecode Edm.Int32

Shows whether the contact is active or inactive. Inactive contacts are read-only and can't be edited unless they are reactivated.

Display Name: Status

Default Options
Value Label
0 Active
1 Inactive
statuscode Edm.Int32

Select the contact's status.

Display Name: Status Reason

Default Options
Value Label
1 Active
2 Inactive
subscriptionid Edm.Guid

For internal use only.

Display Name: Subscription

suffix Edm.String

Type the suffix used in the contact's name, such as Jr. or Sr. to make sure the contact is addressed correctly in sales calls, email, and marketing campaigns.

Display Name: Suffix

telephone1 Edm.String

Type the main phone number for this contact.

Display Name: Business Phone

telephone2 Edm.String

Type a second phone number for this contact.

Display Name: Home Phone

telephone3 Edm.String

Type a third phone number for this contact.

Display Name: Telephone 3

territorycode Edm.Int32

Select a region or territory for the contact for use in segmentation and analysis.

Display Name: Territory

Default Options
Value Label
1 Default Value
timespentbymeonemailandmeetings Edm.String

Total time spent for emails (read and write) and meetings by me in relation to the contact record.

Display Name: Time Spent by me

Read Only
timezoneruleversionnumber Edm.Int32

For internal use only.

Display Name: Time Zone Rule Version Number

traversedpath Edm.String

For internal use only.

Display Name: Traversed Path

utcconversiontimezonecode Edm.Int32

Time zone code that was in use when the record was created.

Display Name: UTC Conversion Time Zone Code

versionnumber Edm.Int64

Version number of the contact.

Display Name: Version Number

Read Only
websiteurl Edm.String

Type the contact's professional or personal website or blog URL.

Display Name: Website

yomifirstname Edm.String

Type the phonetic spelling of the contact's first name, if the name is specified in Japanese, to make sure the name is pronounced correctly in phone calls with the contact.

Display Name: Yomi First Name

yomifullname Edm.String

Shows the combined Yomi first and last names of the contact so that the full phonetic name can be displayed in views and reports.

Display Name: Yomi Full Name

Read Only
yomilastname Edm.String

Type the phonetic spelling of the contact's last name, if the name is specified in Japanese, to make sure the name is pronounced correctly in phone calls with the contact.

Display Name: Yomi Last Name

yomimiddlename Edm.String

Type the phonetic spelling of the contact's middle name, if the name is specified in Japanese, to make sure the name is pronounced correctly in phone calls with the contact.

Display Name: Yomi Middle Name

Lookup Properties

Lookup properties are read-only, computed properties which contain entity primary key Edm.Guid data for one or more corresponding single-valued navigation properties. More information: Lookup properties and Retrieve data about lookup properties.

Name Single-valued navigation property Description
_accountid_value

Unique identifier of the account with which the contact is associated.

_createdby_value createdby

Shows who created the record.

_createdbyexternalparty_value

Shows the external party who created the record.

_createdonbehalfby_value createdonbehalfby

Shows who created the record on behalf of another user.

_defaultpricelevelid_value defaultpricelevelid

Choose the default price list associated with the contact to make sure the correct product prices for this customer are applied in sales opportunities, quotes, and orders.

_masterid_value masterid

Unique identifier of the master contact for merge.

_modifiedby_value modifiedby

Shows who last updated the record.

_modifiedbyexternalparty_value

Shows the external party who modified the record.

_modifiedonbehalfby_value modifiedonbehalfby

Shows who last updated the record on behalf of another user.

_originatingleadid_value originatingleadid

Shows the lead that the contact was created if the contact was created by converting a lead in Microsoft Dynamics 365. This is used to relate the contact to the data on the originating lead for use in reporting and analytics.

_ownerid_value ownerid

Enter the user or team who is assigned to manage the record. This field is updated every time the record is assigned to a different user.

_owningbusinessunit_value owningbusinessunit

Unique identifier of the business unit that owns the contact.

_owningteam_value owningteam

Unique identifier of the team who owns the contact.

_owninguser_value owninguser

Unique identifier of the user who owns the contact.

_parentcontactid_value

Unique identifier of the parent contact.

_parentcustomerid_value parentcustomerid_accountparentcustomerid_contact

Select the parent account or parent contact for the contact to provide a quick link to additional details, such as financial information, activities, and opportunities.

_preferredequipmentid_value preferredequipmentid

Choose the contact's preferred service facility or equipment to make sure services are scheduled correctly for the customer.

_preferredserviceid_value preferredserviceid

Choose the contact's preferred service to make sure services are scheduled correctly for the customer.

_preferredsystemuserid_value preferredsystemuserid

Choose the regular or preferred customer service representative for reference when scheduling service activities for the contact.

_slaid_value slaid_sla

Choose the service level agreement (SLA) that you want to apply to the Contact record.

_slainvokedid_value slainvokedid_contact_sla

Last SLA that was applied to this case. This field is for internal use only.

_transactioncurrencyid_value transactioncurrencyid

Choose the local currency for the record to make sure budgets are reported in the correct currency.

Single-valued navigation properties

Single-valued navigation properties represent lookup fields where a single entity can be referenced. Each single-valued navigation property has a corresponding partner collection-valued navigation property on the related entity.

Name Type Partner
createdby systemuser lk_contactbase_createdby
createdonbehalfby systemuser lk_contact_createdonbehalfby
defaultpricelevelid pricelevel price_level_contacts
masterid contact contact_master_contact
modifiedby systemuser lk_contactbase_modifiedby
modifiedonbehalfby systemuser lk_contact_modifiedonbehalfby
originatingleadid lead contact_originating_lead
ownerid principal owner_contacts
owningbusinessunit businessunit business_unit_contacts
owningteam team team_contacts
owninguser systemuser contact_owning_user
parentcustomerid_account account contact_customer_accounts
parentcustomerid_contact contact contact_customer_contacts
preferredequipmentid equipment equipment_contacts
preferredserviceid service service_contacts
preferredsystemuserid systemuser system_user_contacts
slaid_sla sla manualsla_contact
slainvokedid_contact_sla sla sla_contact
stageid_processstage processstage processstage_contact
transactioncurrencyid transactioncurrency transactioncurrency_contact

Collection-valued navigation properties

Collection-valued navigation properties represent collections of entities which may represent either a one-to-many (1:N) or many-to-many (N:N) relationship between the entities.

Name Type Partner
account_primary_contact account primarycontactid
contact_actioncard actioncard regardingobjectid_contact_actioncard
contact_activity_parties activityparty partyid_contact
Contact_ActivityPointers activitypointer regardingobjectid_contact
Contact_Annotation annotation objectid_contact
Contact_Appointments appointment regardingobjectid_contact_appointment
contact_as_primary_contact incident primarycontactid
contact_as_responsible_contact incident responsiblecontactid
Contact_AsyncOperations asyncoperation regardingobjectid_contact
contact_bookableresource_ContactId bookableresource ContactId
Contact_BulkDeleteFailures bulkdeletefailure regardingobjectid_contact
contact_BulkOperations bulkoperation regardingobjectid_contact_bulkoperation
contact_CampaignResponses campaignresponse regardingobjectid_contact_campaignresponse
contact_connections1 connection record1id_contact
contact_connections2 connection record2id_contact
contact_customer_contacts contact parentcustomerid_contact
Contact_CustomerAddress customeraddress parentid_contact
Contact_DuplicateBaseRecord duplicaterecord baserecordid_contact
Contact_DuplicateMatchingRecord duplicaterecord duplicaterecordid_contact
Contact_Email_EmailSender email emailsender_contact
Contact_Emails email regardingobjectid_contact_email
contact_entitlement_ContactId entitlement contactid
contact_entitlement_Customer entitlement customerid_contact
Contact_Faxes fax regardingobjectid_contact_fax
Contact_Feedback feedback ContactId
Contact_Letters letter regardingobjectid_contact_letter
Contact_MailboxTrackingFolder mailboxtrackingfolder regardingobjectid_contact
contact_master_contact contact masterid
contact_msdyn_approvals msdyn_approval regardingobjectid_contact_msdyn_approval
contact_msdyn_bookingalerts msdyn_bookingalert regardingobjectid_contact_msdyn_bookingalert
Contact_Phonecalls phonecall regardingobjectid_contact_phonecall
contact_PostFollows postfollow regardingobjectid_contact
contact_PostRegardings postregarding regardingobjectid_contact
contact_principalobjectattributeaccess principalobjectattributeaccess objectid_contact
Contact_ProcessSessions processsession regardingobjectid_contact
Contact_RecurringAppointmentMasters recurringappointmentmaster regardingobjectid_contact_recurringappointmentmaster
Contact_ServiceAppointments serviceappointment regardingobjectid_contact_serviceappointment
Contact_SocialActivities socialactivity regardingobjectid_contact_socialactivity
Contact_SyncErrors syncerror regardingobjectid_contact_syncerror
Contact_Tasks task regardingobjectid_contact_task
contactinvoices_association invoice contactinvoices_association
contactleads_association lead contactleads_association
contactorders_association salesorder contactorders_association
contactquotes_association quote contactquotes_association
contract_billingcustomer_contacts contract billingcustomerid_contact
contract_customer_contacts contract customerid_contact
contractlineitem_customer_contacts contractdetail customerid_contact
CreatedContact_BulkOperationLogs bulkoperationlog createdobjectid_contact
entitlementcontacts_association entitlement entitlementcontacts_association
incident_customer_contacts incident customerid_contact
invoice_customer_contacts invoice customerid_contact
lead_customer_contacts lead customerid_contact
lead_parent_contact lead parentcontactid
listcontact_association list listcontact_association
lk_contact_feedback_createdby feedback CreatedByContact
lk_contact_feedback_createdonbehalfby feedback CreatedOnBehalfByContact
ms_contact_ms_newsitem ms_newsitem ms_ContactId
msdyn_contact_msdyn_actual_ContactCustomer msdyn_actual msdyn_ContactCustomer
msdyn_contact_msdyn_actual_ContactVendor msdyn_actual msdyn_ContactVendor
msdyn_contact_msdyn_contactpricelist_Contact msdyn_contactpricelist msdyn_Contact
msdyn_contact_msdyn_estimateline_ContactCustomer msdyn_estimateline msdyn_ContactCustomer
msdyn_contact_msdyn_estimateline_ContactVendor msdyn_estimateline msdyn_ContactVendor
msdyn_contact_msdyn_fact_ContactCustomer msdyn_fact msdyn_ContactCustomer
msdyn_contact_msdyn_fact_ContactVendor msdyn_fact msdyn_ContactVendor
msdyn_contact_msdyn_invoicelinetransaction_ContactCustomer msdyn_invoicelinetransaction msdyn_ContactCustomer
msdyn_contact_msdyn_invoicelinetransaction_ContactVendor msdyn_invoicelinetransaction msdyn_ContactVendor
msdyn_contact_msdyn_journalline_ContactCustomer msdyn_journalline msdyn_ContactCustomer
msdyn_contact_msdyn_journalline_ContactVendor msdyn_journalline msdyn_ContactVendor
msdyn_contact_msdyn_opportunitylinetransaction_ContactCustomer msdyn_opportunitylinetransaction msdyn_ContactCustomer
msdyn_contact_msdyn_opportunitylinetransaction_ContactVendor msdyn_opportunitylinetransaction msdyn_ContactVendor
msdyn_contact_msdyn_orderlinetransaction_ContactCustomer msdyn_orderlinetransaction msdyn_ContactCustomer
msdyn_contact_msdyn_orderlinetransaction_ContactVendor msdyn_orderlinetransaction msdyn_ContactVendor
msdyn_contact_msdyn_quotelinetransaction_ContactCustomer msdyn_quotelinetransaction msdyn_ContactCustomer
msdyn_contact_msdyn_quotelinetransaction_ContactVendor msdyn_quotelinetransaction msdyn_ContactVendor
msdyn_contact_msdyn_rma_RequestedByContact msdyn_rma msdyn_requestedbycontact
msdyn_contact_msdyn_rtv_VendorContact msdyn_rtv msdyn_vendorcontact
msdyn_contact_msdyn_workorder_ReportedByContact msdyn_workorder msdyn_reportedbycontact
opportunity_customer_contacts opportunity customerid_contact
opportunity_parent_contact opportunity parentcontactid
order_customer_contacts salesorder customerid_contact
quote_customer_contacts quote customerid_contact
servicecontractcontacts_association contract servicecontractcontacts_association
slakpiinstance_contact slakpiinstance regarding_contact
socialactivity_postauthor_contacts socialactivity postauthor_contact
socialactivity_postauthoraccount_contacts socialactivity postauthoraccount_contact
Socialprofile_customer_contacts socialprofile customerid_contact
SourceContact_BulkOperationLogs bulkoperationlog regardingobjectid_contact

Operations

The following operations can be used with the contact entity type.

Name Binding
GrantAccess Not Bound
Merge Not Bound
ModifyAccess Not Bound
RetrievePrincipalAccess Not Bound
RetrieveSharedPrincipalsAndAccess Not Bound
RevokeAccess Not Bound
Rollup Not Bound

Solutions

The following solutions include the contact entity type.

Name Description
App for Outlook
Field Service Microsoft Dynamics 365 for Field Service allows organizations of any size to deliver intelligent, world class field service, managing all aspects of the end-to-end field service management cycle. Features include scheduling, mobile, asset management, inventory control, customer notifications, and resource utilization controls that help maximize efficiency and minimize costs.
Unified Resource Scheduling Unified scheduling solution provides the infrastructure to express resource requirements for any entity in the system and help staff those requirements with resources based on the availability and applicability of the resource for the requirement.
Application Common For internal use only.
Lead Management Dynamics 365 workload for lead management.
Marketing Dynamics 365 workload for marketing and enterprise.
Marketing Sales For internal use only.
Product Management Dynamics 365 workload for product management.
Sales Dynamics 365 workload for sales.
Service Dynamics 365 workload for service.
Project Service Automation Microsoft Dynamics 365 for Project Service Automation is an end-to-end solution that helps sales and delivery teams engage customers and deliver billable projects on time and within budget. Project Service gives you the tools you need to: Estimate, quote, and contract work; Plan and assign resources; Enable team collaboration; Capture time, expense, and progress data for real-time insights and accurate invoicing.
System Solution Internal CRM System Solution

See also