--- schema_version: "1" id: ca66956eb9661f58077530debd381d88081bc90c35c1b263890d6f87d3be1912 title: DataUsePurpose collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_datausepurpose.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_datausepurpose.htm source_site: developer.salesforce.com content_type: documentation content_hash: e55d85f2a70eaad848da1c3d649c9ae0c8d1dedb644b3e44d4c35aeddbdb2de8 description: Represents the reason for contacting a prospect or customer, such as for billing, marketing, or surveys. This object is available in API version 45.0 and later. --- # DataUsePurpose Represents the reason for contacting a prospect or customer, such as for billing, marketing, or surveys. This object is available in API version 45.0 and later. ## Supported Calls create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert() ## Special Access Rules This object is available if Data Protection and Privacy is enabled. ## Fields | Field Name | Details | | --- | --- | | CanDataSubjectOptOut | Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Required. Indicates whether the customer can decline contact for the described purpose. | | Description | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Indicates the purpose for contacting a customer. | | LastReferencedDate | Type dateTime Properties Filter, Nillable, Sort Description The timestamp for when the current user last viewed a record related to this record. | | LastViewedDate | Type dateTime Properties Filter, Nillable, Sort Description The timestamp for when the current user last viewed this record. If this value is null, it’s possible that this record was referenced (LastReferencedDate) and not viewed. | | LegalBasisId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description Identifies the legal basis record associated with the data use purpose. This is a relationship field. Relationship Name LegalBasis Relationship Type Lookup Refers To DataUseLegalBasis | | Name | Type string Properties Create, Filter, Group, idLookup, Sort, Update Description Required. Identifies the reason for contacting a customer. For example, billing or marketing. | | OwnerId | Type reference Properties Create, Defaulted on create, Filter, Group, Sort, Update Description The ID of the owner of the account associated with this customer. This is a polymorphic relationship field. Relationship Name Owner Relationship Type Lookup Refers To Group, User | | PurposeId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The ID of an object containing data specific to the data use purpose. This is a polymorphic relationship field. Relationship Name Purpose Relationship Type Lookup Refers To Asset, CareProgram, CareRegisteredDevice, or Product2 | ## Associated Objects This object has the following associated objects. Unless noted, they’re available in the same API version as this object. [DataUsePurposeChangeEvent](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_change_event.htm "A ChangeEvent object is available for each object that supports Change Data Capture. You can subscribe to a stream of change events using Change Data Capture to receive data tied to record changes in Salesforce. Changes include record creation, updates to an existing record, deletion of a record, and undeletion of a record. A change event isn’t a Salesforce object—it doesn’t support CRUD operations or queries. It’s included in the object reference so you can discover which Salesforce objects support change events.") (API version 62.0) Change events are available for the object. [DataUsePurposeHistory](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_history.htm "StandardObjectNameHistory is the model for all history objects associated with standard objects. These objects represent the history of changes to the values in the fields of a standard object.") History is available for tracked fields of the object. [DataUsePurposeOwnerSharingRule](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_ownersharingrule.htm "StandardObjectNameOwnerSharingRule is the model for all owner sharing rule objects associated with standard objects. These objects represent a rule for sharing a standard object with users other than the owner.") Sharing rules are available for the object. [DataUsePurposeShare](https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_associated_objects_share.htm "StandardObjectNameShare is the model for all share objects associated with standard objects. These objects represent a sharing entry on the standard object.") Sharing is available for the object.