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:
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 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: In Sync, Different, Reviewed, Not Found, Inactive, Not Compared, Select Match, or Skipped.
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.com (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.
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 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 (beta)
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.
MailingLatitude (beta)
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.
MailingLongitude (beta)
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.
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 (beta)
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Middle name of the contact. Maximum size is 40 characters. Contact salesforce.com 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 (beta), LastName, and Suffix (beta). Maximum size is 121 characters.
OtherAddress (beta)
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.
OtherLatitude (beta)
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.
OtherLongitude (beta)
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.
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://na1.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 (beta)
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Name suffix of the contact. Maximum size is 40 characters. Contact salesforce.com 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.
Note
If you are importing Contact data and need to set the value for an audit field, such as CreatedDate, contact salesforce.com. Audit fields are automatically updated during API operations unless you request to set these fields yourself..

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.

© Copyright 2000–2014 salesforce.com, inc. All rights reserved.
Various trademarks held by their respective owners.