Contact

Represents a contact, which is a person associated with an account.

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.

Important

Supported Calls

create(), delete(), describeLayout(), describeSObjects(), getDeleted(), getUpdated(), merge(), query(), retrieve(), search(), undelete(), update(), upsert()

Special Access Rules

Customer Portal users can access only portal-enabled contacts.

Fields

Field	Details
AccountId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description ID of the account that’s the parent of this contact. We recommend that you update up to 50 contacts simultaneously when changing the accounts on contacts enabled for a Customer Portal or partner portal. We also recommend that you make this update after business hours. This is a relationship field. Relationship Name Account Relationship Type Lookup Refers To Account
AssistantName	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The assistant’s name.
AssistantPhone	Type phone Properties Create, Filter, Group, Nillable, Sort, Update Description The assistant’s phone number. Label is Asst. Phone.
Birthdate	Type date Properties Create, Filter, Group, Nillable, Sort, Update Description The contact’s birthdate. Filter criteria for report filters, list view filters, and SOQL queries ignore the year portion of the Birthdate field. For example, this SOQL query returns contacts with birthdays later in the year than today: `1SELECT Name, Birthdate 2FROM Contact 3WHERE Birthdate > TODAY`
CanAllowPortalSelfReg	Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates whether this contact can self-register for your Customer Portal (`true`) or not (`false`).
CleanStatus	Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description Indicates the record’s clean status as compared with Data.com. Values include: `Matched`, `Different`, `Acknowledged`, `NotFound`, `Inactive`, `Pending`,`SelectMatch`, or `Skipped`. Several values for CleanStatus appear with different labels on the contact record. `Matched` appears as `In Sync` `Acknowledged` appears as `Reviewed` `Pending` appears as `Not Compared`
ConnectionReceivedId	Type reference Properties Filter, Group, Nillable, Sort Description ID of the PartnerNetworkConnection that shared this record with your organization. This field is available if you enabled Salesforce to Salesforce.
ConnectionSentId	Type reference Properties Filter, Group, Nillable, Sort Description ID of the PartnerNetworkConnection that you shared this record with. This field is available if you enabled Salesforce to Salesforce. This field is supported using API versions earlier than 15.0. In all other API versions, this field’s value is null. You can use the new PartnerNetworkRecordConnection object to forward records to connections.
Department	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The contact’s department.
Description	Type textarea Properties Create, Nillable, Update Description A description of the contact. Label is Contact Description up to 32 KB.
DoNotCall	Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates that the contact doesn’t want to receive calls.
Email	Type email Properties Create, Filter, Group, idLookup, Nillable, Sort, Update Description The contact’s email address.
EmailBouncedDate	Type dateTime Properties Create, Filter, Nillable, Sort, Update Description If bounce management is activated and an email sent to the contact bounces, the date and time of the bounce. Email bounce functionality isn't triggered by record updates, including updates to this field. Note
EmailBouncedReason	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description If bounce management is activated and an email sent to the contact bounces, the reason for the bounce. Email bounce functionality isn't triggered by record updates, including updates to this field. Note
Fax	Type phone Properties Create, Filter, Group, Nillable, Sort, Update Description The contact’s fax number. Label is Business Fax.
FirstCallDateTime	Type dateTime Properties Filter, Nillable, Sort Description The date and time of the first call placed to the contact. This field is available in API version 48.0 and later if you enabled Sales Engagement.
FirstEmailDateTime	Type dateTime Properties Filter, Nillable, Sort Description The date and time of the first email sent to the contact. This field is available in API version 48.0 and later if you enabled Sales Engagement.
FirstName	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The contact’s first name up to 40 characters.
GenderIdentity	Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The contact’s internal experience of their gender, which may or may not correspond to their designated sex at birth.
HasOptedOutOfEmail	Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates whether the contact doesn’t want to receive email from Salesforce (`true`) or does (`false`). Label is Email Opt Out.
HasOptedOutOfFax	Type boolean Properties Create, Defaulted on create, Filter, Group, Sort, Update Description Indicates whether the contact prohibits receiving faxes.
HomePhone	Type phone Properties Create, Filter, Group, Nillable, Sort, Update Description The contact’s home phone number. Label is Home Phone.
IndividualId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description ID of the data privacy record associated with this contact. This field is available if Data Protection and Privacy is enabled. This is a relationship field. Relationship Name Individual Relationship Type Lookup Refers To Individual
IsDeleted	Type boolean Properties Defaulted on create, Filter Description Indicates whether the object has been moved to the Recycle Bin (`true`) or not (`false`). Label is Deleted.
IsEmailBounced	Type boolean Properties Defaulted on create, Filter, Group, Sort Description If bounce management is activated and an email is sent to a contact, indicates whether the email bounced (`true`) or not (`false`).
IsPersonAccount	Type boolean Properties Defaulted on create, Filter, Group, Sort Description Read only. Indicates whether this account has a record type of Person Account (`true`) or not (`false`). Label is Is Person Account.
Jigsaw	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description References the company’s ID in Data.com. If an account has a value in this field, it means that the account was imported from Data.com. If the field value is `null`, the account wasn’t imported from Data.com. Maximum size is 20 characters. Available in API version 22.0 and later. Label is Data.com Key. The Jigsaw field is exposed in the API to support troubleshooting for import errors and reimporting of corrected data. Do not modify this value. Important
LastActivityDate	Type date Properties Filter, Group, Nillable, Sort Description Value is the most recent of either: Due date of the most recent event logged against the record. Due date of the most recently closed task associated with the record.
LastName	Type string Properties Create, Filter, Group, Sort, Update Description Required. Last name of the contact up to 80 characters.
LastReferencedDate	Type dateTime Properties Filter, Nillable, Sort Description The timestamp when the current user last accessed this record, a record related to this record, or a list view.
LastViewedDate	Type dateTime Properties Filter, Nillable, Sort Description The timestamp when the current user last viewed this record or list view. If this value is null, the user might have only accessed this record or list view (LastReferencedDate) but not viewed it.
LeadSource	Type picklist Properties Create, Filter, Group, Nillable, Sort, Update Description The source of the lead that was converted to this contact.
MailingAddress	Type address Properties Filter, Nillable Description The compound form of the mailing address. Read-only. For details on compound address fields, see Address Compound Fields.
MailingCity	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Mailing address details.
MailingCountry	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Mailing address details.
MailingCountryCode	Type picklist Properties Create, Filter, Group, Nillable, Sort, Update Description The ISO codes for the mailing address’s state and country.
MailingGeocodeAccuracy	Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update, Query, Restricted picklist, Nillable Description Accuracy level of the geocode for the mailing address. For details on geolocation compound field, see Compound Field Considerations and Limitations.
MailingLatitude	Type double Properties Create, Filter, Nillable, Sort, Update Description Used with MailingLongitude to specify the precise geolocation of a mailing address. Acceptable values are numbers between –90 and 90 up to 15 decimal places. For details on geolocation compound fields, see Compound Field Considerations and Limitations.
MailingLongitude	Type double Properties Create, Filter, Nillable, Sort, Update Description Used with MailingLatitude to specify the precise geolocation of a mailing address. Acceptable values are numbers between –180 and 180 up to 15 decimal places. For details on geolocation compound fields, see Compound Field Considerations and Limitations.
MailingPostalCode	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Mailing address details.
MailingState	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Mailing address details.
MailingStateCode	Type picklist Properties Create, Filter, Group, Nillable, Sort, Update Description The ISO codes for the mailing address’s state and country.
MailingStreet	Type textarea Properties Create, Filter, Group, Nillable, Sort, Update Description Street address for mailing address.
MasterRecordId	Type reference Properties Filter, Group, Nillable, Sort Description If this record was deleted as the result of a merge, this field contains the ID of the record that remains. If this record was deleted for any other reason, or hasn’t been deleted, the value is `null`. This is a relationship field. Relationship Name MasterRecord Relationship Type Lookup Refers To Contact
MiddleName	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The contact’s middle name up to 40 characters. To enable this field, ask Salesforce Customer Support for help.
MobilePhone	Type phone Properties Create, Filter, Group, Nillable, Sort, Update Description Contact’s mobile phone number. Label is Mobile Phone.
Name	Type string Properties Filter, Group, Sort Description Concatenation of FirstName, MiddleName, LastName, and Suffix up to 203 characters, including whitespaces.
OtherAddress	Type address Properties Filter, Nillable Description The compound form of the other address. Read-only. For details on compound address fields, see Address Compound Fields.
OtherCity	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Alternate address details.
OtherCountry	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Alternate address details.
OtherCountryCode	Type picklist Properties Create, Filter, Group, Nillable, Sort, Update Description The ISO codes for the alternate address’s state and country.
OtherGeocodeAccuracy	Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description Accuracy level of the geocode for the other address. For details on geolocation compound fields, see Compound Field Considerations and Limitations.
OtherLatitude	Type double Properties Create, Filter, Nillable, Sort, Update Description Used with OtherLongitude to specify the precise geolocation of an alternate address. Acceptable values are numbers between –90 and 90 up to 15 decimal places. For details on geolocation compound fields, see Compound Field Considerations and Limitations.
OtherLongitude	Type double Properties Create, Filter, Nillable, Sort, Update Description Used with OtherLatitude to specify the precise geolocation of an alternate address. Acceptable values are numbers between –180 and 180 up to 15 decimal places. For details on geolocation compound fields, see Compound Field Considerations and Limitations.
OtherPhone	Type phone Properties Create, Filter, Group, Nillable, Sort, Update Description Phone for alternate address.
OtherPostalCode	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Alternate address details.
OtherState	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Alternate address details.
OtherStateCode	Type picklist Properties Create, Filter, Group, Nillable, Sort, Update Description The ISO codes for the alternate address’s state and country.
OtherStreet	Type textarea Properties Create, Filter, Group, Nillable, Sort, Update Description Street for alternate address.
OwnerId	Type reference Properties Create, Defaulted on create, Filter, Group, Sort, Update Description The ID of the owner of the account associated with this contact. This is a relationship field. Relationship Name Owner Relationship Type Lookup Refers To User
Phone	Type phone Properties Create, Filter, Group, Nillable, Sort, Update Description Phone number for the contact. Label is Business Phone.
PhotoUrl	Type url Properties Filter, Group, Nillable, Sort Description Path to be combined with the URL of a Salesforce instance (Example: https://`yourInstance`.salesforce.com/) to generate a URL to request the social network profile image associated with the contact. Generated URL returns an HTTP redirect (code 302) to the social network profile image for the contact. Empty if Social Accounts and Contacts isn't enabled or if Social Accounts and Contacts is disabled for the requesting user.
Pronouns	Type picklist Properties Create, Filter, Group, Nillable, Restricted picklist, Sort, Update Description The contact’s personal pronouns, reflecting their gender identity. Others can use these pronouns to refer to the contact in the third person. The entry is selected from a picklist of available values, which the administrator sets. Maximum 40 characters.
RecordTypeId	Type reference Properties Create, Filter, Nillable, Update Description ID of the record type assigned to this object.
ReportsToId	Type reference Properties Create, Filter, Group, Nillable, Sort, Update Description This field doesn’t appear if IsPersonAccount is `true`. This is a relationship field. Relationship Name ReportsTo Relationship Type Lookup Refers To Contact
Salutation	Type picklist Properties Create, Filter, Group, Nillable, Sort, Update Description Honorific abbreviation, word, or phrase to be used in front of name in greetings, such as Dr. or Mrs.
Suffix	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Name suffix of the contact up to 40 characters. To enable this field, ask Salesforce Customer Support for help.
Title	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Title of the contact, such as CEO or Vice President.

If you’re importing contact data and need to set the value for an audit field, such as CreatedDate, contact Salesforce. Audit fields are automatically updated during API operations unless you request to set these fields yourself.

Note

Usage

Use this object to manage individual people who are associated with an account. You can create, query, delete, or update any attachment associated with a contact.

Create or update contacts by converting a lead with the convertLead() call.

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.

AccountChangeEvent (API version 44.0): Change events are available for the object.
ContactFeed (API version 18.0): Feed tracking is available for the object.
ContactHistory (API version 11.0): History is available for tracked fields of the object.
ContactOwnerSharingRule: Sharing rules are available for the object.
ContactShare: Sharing is available for the object.

Object Reference for the Salesforce Platform