Contact

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

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.
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`
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.
Fax	Type phone Properties Create, Filter, Group, Nillable, Sort, Update Description The contact’s fax number. Label is Business Fax.
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.
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
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
LastCURequestDate	Type dateTime Properties Filter, Nillable, Sort Description The last date that a Stay-in-Touch request was sent to the contact.
LastCUUpdateDate	Type dateTime Properties Filter, Nillable, Sort Description The last time a Stay-in-Touch update was processed for the contact.
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 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.
LeadSource	Type picklist Properties Create, Filter, Group, Nillable, Sort, Update Description The lead’s source.
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.
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.
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.
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.
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.
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.

ContactChangeEvent: Change events are available for the object.
ContactFeed: Feed tracking is available for the object.
ContactHistory: History is available for tracked fields of the object.
ContactShare: Sharing is available for the object.