Contact

Represents a contact, which is an individual 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 is the parent of this contact. We recommend that you only 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 during times outside of your organization's business hours.
AssistantName	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description The name of the assistant.
AssistantPhone	Type phone Properties Create, Filter, Group, Nillable, Sort, Update Description The telephone number of the assistant.
Birthdate	Type date Properties Create, Filter, Group, Nillable, Sort, Update Description The birthdate of the contact. The year portion of the Birthdate field is ignored in filter criteria, including report filters, list view filters, and SOQL queries. For example, the following 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, Update Description Indicates whether this contact can self-register for your organization's 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 are: `Matched`, `Different`, `Acknowledged`, `NotFound`, `Inactive`, `Pending`,`SelectMatch`, or `Skipped`. Several values for CleanStatus display with different labels on the contact record detail page. `Matched` displays as `In Sync` `Acknowledged` displays as `Reviewed` `Pending` displays as `Not Compared`
ConnectionReceivedId	Type reference Properties Filter, Nillable Description ID of the PartnerNetworkConnection that shared this record with your organization. This field is only available if you have enabled Salesforce to Salesforce.
ConnectionSentId	Type reference Properties Filter, Nillable Description ID of the PartnerNetworkConnection that you shared this record with. This field is only available if you have enabled Salesforce to Salesforce. Beginning with API version 15.0, the ConnectionSentId field is no longer supported. The ConnectionSentId field is still visible, but the 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 department of the contact.
Description	Type textarea Properties Create, Nillable, Update Description A description of the contact. Label is Contact Description. Limit: 32 KB.
DoNotCall	Type boolean Properties Create, Defaulted on create, Filter, Update Description Indicates that the contact does not wish to be called.
Email	Type email Properties Create, Filter, Group, Nillable, Sort, Update Description Email address for the contact.
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 the bounce occurred.
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 the bounce occurred.
Fax	Type phone Properties Create, Filter, Group, Nillable, Sort, Update Description Fax number for the contact. Label is Business Phone.
FirstName	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description First name of the contact. Maximum size is 40 characters.
HasOptedOutOfEmail	Type boolean Properties Create, Defaulted on create, Filter, Update Description Indicates whether the contact would prefer not to receive email from Salesforce (`true`) or not (`false`). Label is Email Opt Out.
HasOptedOutOfFax	Type boolean Properties Create, Defaulted on create, Filter, Update Description Indicates that the contact does not wish to receive faxes.
HomePhone	Type phone Properties Create, Filter, Group, Nillable, Sort, Update Description Home telephone number for the contact.
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 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 Description Read only. Label is Is Person Account. Indicates whether this account has a record type of Person Account (`true`) or not (`false`).
Jigsaw	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description References the ID of a company 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 was not 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 one of the following, whichever is the most recent: Due date of the most recent event logged against the record. Due date of the most recently closed task associated with the record.
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. Maximum size is 80 characters.
LastReferencedDate	Type date Properties Filter, Nillable, Sort, Update Description The timestamp for when the current user last viewed a record related to this record.
LastViewedDate	Type date Properties Filter, Nillable, Sort, Update Description The timestamp for when the current user last viewed this record. If this value is null, this record might only have been referenced (LastReferencedDate) and not viewed.
LeadSource	Type picklist Properties Create, Filter, Group, Nillable, Sort, Update Description The source of the lead.
MailingAddress	Type address Properties Filter, Nillable Description The compound form of the mailing address. Read-only. See Address Compound Fields for details on compound address fields.
MailingCity MailingState MailingCountry MailingPostalCode	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Details for the mailing address.
MailingStateCode MailingCountryCode	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.
MailingGeocodeAccuracy	Type picklist Properties Retrieve, Query, Restricted picklist, Nillable Description Accuracy level of the geocode for the mailing address. See Compound Field Considerations and Limitations for details on geolocation compound fields.
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 with up to 15 decimal places. See Compound Field Considerations and Limitations for details on geolocation compound fields.
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 with up to 15 decimal places. See Compound Field Considerations and Limitations for details on geolocation compound fields.
MasterRecordId	Type reference Properties Filter, Group, Nillable, Sort Description If this object was deleted as the result of a merge, this field contains the ID of the record that was kept. If this object was deleted for any other reason, or has not been deleted, the value is `null`.
MiddleName	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Middle name of the contact. Maximum size is 40 characters. Contact Salesforce Customer Support to enable this field.
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. Maximum size is 121 characters.
OtherAddress	Type address Properties Filter, Nillable Description The compound form of the other address. Read-only. See Address Compound Fields for details on compound address fields.
OtherCity OtherCountry OtherPostalCode OtherState	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Details for alternate address.
OtherCountryCode OtherStateCode	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 Retrieve, Query, Restricted picklist, Nillable Description Accuracy level of the geocode for the other address. See Compound Field Considerations and Limitations for details on geolocation compound fields.
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 with up to 15 decimal places. See Compound Field Considerations and Limitations for details on geolocation compound fields.
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 with up to 15 decimal places. See Compound Field Considerations and Limitations for details on geolocation compound fields.
OtherPhone	Type phone Properties Create, Filter, Group, Nillable, Sort, Update Description Telephone for alternate address.
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.
Phone	Type phone Properties Create, Filter, Group, Nillable, Sort, Update Description Telephone 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 (for 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. Blank if Social Accounts and Contacts isn't enabled for the organization or if Social Accounts and Contacts is disabled for the requesting user.
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 is not visible if IsPersonAccount is `true`.
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. Maximum size is 40 characters. Contact Salesforce Customer Support to enable this field.
Title	Type string Properties Create, Filter, Group, Nillable, Sort, Update Description Title of the contact such as CEO or Vice President.

If you are 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 individuals who are associated with an Account in your organization. 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.

Object Reference for Salesforce and Force.com

Contact

Supported Calls

Special Access Rules

Fields

Usage

See Also: