--- schema_version: "1" id: d0de68b926ef9991b0f561cd39d49edfc6fa8f83f0f1a26584d72f849cc09270 title: ContactPointPhone collection: legacydeveloper version: current locale: en-us portal_url: https://docs.salesforce.com/legacydeveloper/current/en-us/object_reference/sforce_api_objects_contactpointphone.md canonical_url: https://developer.salesforce.com/docs/atlas.en-us.object_reference.meta/object_reference/sforce_api_objects_contactpointphone.htm source_site: developer.salesforce.com content_type: documentation content_hash: 843b55658319a8d9acb36873208ec86f950def6cb0d964c65876b01b6c6adc7f description: Represents a contact’s phone number, which is associated with an individual or person account. This object is available in API version 48.0 and later. --- # ContactPointPhone Represents a contact’s phone number, which is associated with an individual or person account. This object is available in API version 48.0 and later. ## Supported Calls create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), query(), retrieve(), search(), undelete(), update(), upsert() ## Fields | Field | Details | | --- | --- | | ActiveFromDate | Type date Properties Create, Filter, Group, Nillable, Sort, Update Description The date when the contact’s phone number became active. | | ActiveToDate | Type date Properties Create, Filter, Group, Nillable, Sort, Update Description The date when the contact’s phone number is no longer active. | | AreaCode | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The area code of the phone number’s location for the contact. | | BestTimeToContactEndTime | Type time Properties Create, Filter, Nillable, Sort, Update Description The latest time to contact the individual. | | BestTimeToContactStartTime | Type time Properties Create, Filter, Nillable, Sort, Update Description The earliest time to contact the individual. | | BestTimeToContactTimezone | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The timezone applied to the best time to contact the individual. | | ExtensionNumber | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The phone number extension for the contact. | | FormattedInternationalPhoneNumber | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The internationally recognized format for the contact’s phone number. | | FormattedNationalPhoneNumber | Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The nationally recognized format for the contact’s phone number. | | IsBusinessPhone | Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates whether a contact’s phone number is a business number (true) or not (false). | | IsFaxCapable | Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates whether a contact’s phone number is a fax number (true) or not (false). | | IsPersonalPhone | Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates whether a contact’s phone number is a personal number (true) or not (false). | | IsPrimary | Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates whether a contact’s phone number is their primary number (true) or not (false). | | IsSmsCapable | Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates whether a contact’s phone number can receive text messages (true) or not (false). | | 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. | | Name | Type string Properties Filter, Group, idLookup, Nillable, Sort Description Required. The name of the contact point phone record. | | OwnerId | Type reference Properties Create, Defaulted on create, Filter, Group, Sort, Update Description The ID of the account’s owner associated with this contact. This is a polymorphic relationship field. Relationship Name Owner Relationship Type Lookup Refers To Group, User | | ParentId | Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description The ID of the contact’s parent. Only an individual or account can be a contact’s parent. This is a polymorphic relationship field. Relationship Name Parent Relationship Type Lookup Refers To Account, Individual | | PhoneType | Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The type of phone number for the contact. Possible values are: - Home - Mobile | | PreferenceRank | Type int Properties Create, Filter, Group, Nillable, Sort, Update Description Specify how this phone numbers ranks in terms of preference among the contact’s other phone numbers. | | TelephoneNumber | Type phone Properties Create, Filter, Group, Sort, Update Description Required. The phone number for the contact. | | UsageType | Type picklist Properties Create, Filter, Group, Nillable, Sort, Update Description Specify the usage type of this number. For instance, whether it’s a work phone or a home phone. Possible values are: - Home - Temp - Work | ## 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. [ContactPointConsentChangeEvent](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.") Change events are available for the object. [ContactPointPhoneHistory](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. [ContactPointPhoneOwnerSharingRule](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. [ContactPointPhoneShare](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.