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.

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 telephone 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, these SOQL query returns contacts with birthdays later in the year than today:
SELECT Name, Birthdate
FROM Contact
WHERE Birthdate > TODAY
CanAllowPortalSelfReg
Type
boolean
Properties
Create, Defaulted on create, Filter, 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, Nillable
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, Nillable
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, Update
Description
Indicates that the contact does not 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.
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.
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.
HasOptedOutOfEmail
Type
boolean
Properties
Create, Defaulted on create, Filter, Update
Description
Indicates whether the contact prohibits receiving email from Salesforce (true) or not (false). Label is Email Opt Out.
HasOptedOutOfFax
Type
boolean
Properties
Create, Defaulted on create, Filter, Update
Description
Indicates whether the contact prohibits receiving faxes.
HomePhone
Type
phone
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The contact’s home telephone 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.
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. 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 was not imported from Data.com. Maximum size is 20 characters. Available in API version 22.0 and later. Label is Data.com Key.
Important

Important

The Jigsaw field is exposed in the API to support troubleshooting for import errors and reimporting of corrected data. Do not modify this value.

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
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 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
  • MailingState
  • MailingCountry
  • MailingPostalCode
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Mailing address details.
  • 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. 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.
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 has not been deleted, the value is null.
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 121 characters.
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
  • OtherCountry
  • OtherPostalCode
  • OtherState
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Alternate address details.
  • 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. 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
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 (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.

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.
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.
Note

Note

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..

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.

See Also