Contact entity messages and methods

 

Applies To: Dynamics CRM 2013

A contact represents a person with whom a business unit has a relationship. For example, this could be a customer, a supplier, or a colleague. The schema name for this entity is Contact. To view the entity metadata for your organization, install the Metadata Browser solution described in Browse the metadata for your organization. You can also view the metadata for an uncustomized organization in the Excel file called EntityMetadata.xlsx included in the top-level folder of the SDK download.

The following table describes the messages for this entity, which you use with the IOrganizationService.Execute method.

Message	Description
AssignRequest	Assigns a contact to another user or team.
CreateRequest	Creates a contact. You can also call the IOrganizationService.Create method.
DeleteRequest	Deletes a contact. You can also call the IOrganizationService.Delete method.
GrantAccessRequest	Shares a contact with another security principal (user or team).
MergeRequest	Merges two contacts.
ModifyAccessRequest	Changes the access rights for a contact previously shared with another security principal (user or team).
RetrieveRequest	Retrieves a contact. You can also call the IOrganizationService.Retrieve method.
RetrieveMultipleRequest	Retrieves a collection of contacts. You can also call the IOrganizationService.RetrieveMultiple method.
RetrievePrincipalAccessRequest	Retrieves the access that the specified security principal (user or team) has to a contact.
RetrieveSharedPrincipalsAndAccessRequest	Retrieves the security principals (users or teams) that have access to a contact, and their access rights to the contact.
RevokeAccessRequest	Removes all access to a contact for the specified security principal (user or team).
SetStateRequest	Sets the state of a contact. Sets the state of an account. The possible states are defined in the Contact.State attribute. If you are using early bound types, use the ContactState enumeration. For a list of the state values, refer to the contact entity metadata. You can find this information in the metadata for your organization. See the preceding metadata browser information.
UpdateRequest	Updates a contact. You can also call the IOrganizationService.Update method.

See Also

Customer entities (account, contact)
Contact entity privileges