--- schema_version: "1" id: cdb08d906d61a6514c4a56a7ad3c65247b3b587e1635b9d9370c0c2f8b3bed23 title: PersonName collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/health_cloud_object_reference/hc_r4_api_objects_PersonName.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/hc_r4_api_objects_PersonName.htm source_site: developer.salesforce.com content_type: documentation content_hash: 42d02bc94f2da8f059ab29c95b54d840698d70954779b211cc1f77b26e8891c2 description: Represents detailed information about a person’s name. This object is available in API version 51.0 and later. --- # PersonName Represents detailed information about a person’s name. This object is available in API version 51.0 and later. ![Important](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/images/icon_note_important.png) #### Important Where possible, we changed noninclusive terms to align with our company value of Equality. We maintained certain terms to avoid any effect on customer implementations. ## Supported Calls create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert() ## Fields ### EffectiveDate - **Type**: date - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The date from when the name is in effect. ### EndDate - **Type**: date - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The date from when the name is no longer in use. ### FirstName - **Type**: string - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The first name of the person. ### FullName - **Type**: string - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The combination of the first and last names of the person. ### IsPrimary - **Type**: boolean - **Properties**: Create, Defaulted on create, Filter, Group, Sort, Update - **Description**: Indicates whether the name is the person’s primary name. ### LastName - **Type**: string - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The person’s last name. In case the person’s name has more than just a first name and a last name, this field stores the combination of all names except the first name. ### LastReferencedDate - **Type**: dateTime - **Properties**: Filter, Nillable, Sort - **Description**: The date and time when the record was last referenced. ### LastViewedDate - **Type**: dateTime - **Properties**: Filter, Nillable, Sort - **Description**: The date and time when the record was last viewed. ### Name - **Type**: string - **Properties**: Autonumber, Defaulted on create, Filter, idLookup, Sort - **Description**: The system-generated name of the PersonName record. ### NameUsageType - **Type**: picklist - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: Specifies the usage context of the name. - **Possible values**: - Anonymous - Maiden - Nickname - Official - Old - Temp - Usual ### OwnerId - **Type**: Reference - **Properties**: Create, Defaulted on Create, Filter, Group, Sort, Update - **Description**: The owner of the record. - **Referenced Objects**: - User - Group ### ParentRecordId - **Type**: Polymorphic master-detail reference - **Properties**: Create, Filter, Group, Sort - **Description**: References the person the name belongs to. - **Referenced Objects**: - Account - Contact ### Prefix - **Type**: string - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The prefix of the person’s name. ### SourceSystem - **Type**: string - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The source system from where the PersonName record was brought into Health Cloud. ### SourceSystemIdentifier - **Type**: string - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The identifier of the person name record in its source system. ### SourceSystemModified - **Type**: dateTime - **Properties**: Create, Filter, Nillable, Sort, Update - **Description**: The date and time when the person name record was last modified in its source system. ### Suffix - **Type**: string - **Properties**: Create, Filter, Group, Nillable, Sort, Update - **Description**: The suffix of the person’s name. ## Usage PersonName is a data type-like object that’s associated to different objects representing people. The names and name-related information of a person are associated to them by referencing their account, contact, or person account records using the ParentRecordId field on PersonName. ## Associated Objects This object has the following associated objects. If the API version isn’t specified, they’re available in the same API versions as this object. Otherwise, they’re available in the specified API version and later. [PersonNameFeed](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/sforce_api_associated_objects_feed.htm "StandardObjectNameFeed is the model for all feed objects associated with standard objects. These objects represent the posts and feed-tracked changes of a standard object.") Feed tracking is available for the object. [PersonNameHistory](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_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. [PersonNameOwnerSharingRule](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_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. [PersonNameShare](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_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. [PersonNameChangeEvent](https://developer.salesforce.com/docs/atlas.en-us.health_cloud_object_reference.meta/health_cloud_object_reference/sforce_api_associated_objects_change_event.htm "A StandardObjectNameChangeEvent 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 61.0) Change events are available for the object. ## Additional information ◊