Contact

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

Supported Calls

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

Special Access Rules

Customer Portal users can access only portal-enabled contacts.

Fields

Field	Field Type	Field Properties	Description
AccountId	reference	Create Filter Nillable Update	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	string	Create Filter Nillable Update	The name of the assistant.
AssistantPhone	phone	Create Filter Nillable Update	The telephone number of the assistant.
Birthdate	date	Create Filter Nillable Update	The birthdate of the contact.
CanAllowPortalSelfReg	boolean	Create Defaulted on create Filter Update	Indicates whether this contact can self-register for your organization's Customer Portal (`true`) or not (`false`). For more information about the Customer Portal and self-registration, see “Enabling Customer Portal Login and Settings” in the Salesforce.com online help.
ConnectionReceivedId	reference	Filter Nillable	ID of the PartnerNetworkConnection that shared this record with your organization. This field is only available if you have enabled Salesforce to Salesforce.
ConnectionSentId	reference	Filter Nillable	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	string	Create Filter Nillable Update	The department of the contact.
Description	textarea	Create Nillable Update	A description of the contact. Label is Contact Description. Limit: 32 KB.
Email	email	Create Filter idLookup Nillable Update	Email address for the contact.
EmailBouncedDate	dateTime	Create Filter Nillable Update	If bounce management isactivated and an email sent to the contact bounces, the date and time the bounce occurred.
EmailBouncedReason	string	Create Filter Nillable Update	If bounce management is activated and an email sent to the contact bounces, the reason the bounce occurred.
Fax	phone	Create Filter Nillable Update	Fax number for the contact. Label is Business Phone.
FirstName	string	Create Filter Nillable Update	First name of contact. Limited to 40 characters.
HasOptedOutofEmail	boolean	Create Defaulted on create Filter Update	Indicates whether the contact would prefer not to receive email from salesforce.com (`true`) or not (`false`). Label is Email Opt Out.
HomePhone	phone	Create Filter Nillable Update	Home telephone number for the contact.
IsDeleted	boolean	Defaulted on create Filter	Indicates whether the object has been moved to the Recycle Bin (`true`) or not (`false`). Label is Deleted.
IsPersonAccount	boolean	Defaulted on create Filter	Indicates whether this contact is the sole child contact of a person account (`true`) or not (`false`). For more information about person accounts, see Person Account Record Types and the Salesforce.com online help.
LastActivityDate	date	Filter Nillable	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	dateTime	Filter Nillable	The last date that a Stay-in-Touch request was sent to the contact.
LastCUUpdateDate	dateTime	Filter Nillable	The last time a Stay-in-Touch update was processed for the contact.
LastName	string	Create Filter Update	Required. Last name of contact. Limited to 80 characters.
LeadSource	picklist	Create Filter Nillable Update	The source of the lead.
MailingCity MailingState MailingCountry MailingPostalCode	string	Create Filter Nillable Update	Details for the mailing address.
MailingStreet	textarea	Create Filter Nillable Update	Street address for mailing address.
MasterRecordId	reference	Filter Nillable	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`.
MobilePhone	phone	Create Filter Nillable Update	Contact’s mobile phone number.
Name	string	Filter	Concatenation of FirstName and LastName. Limited to 121 characters.
OtherCity OtherCountry OtherPostalCode OtherState	string	Create Filter Nillable Update	Details for alternate address.
OtherPhone	phone	Create Filter Nillable Update	Telephone for alternate address.
OtherStreet	textarea	Create Filter Nillable Update	Street for alternate address.
OwnerId	reference	Create Defaulted on create Filter Update	The ID of the owner of the account associated with this contact.
Phone	phone	Create Filter Nillable Update	Telephone number for the contact. Label is Business Phone.
RecordTypeId	reference	Create Filter Nillable Update	ID of the record type assigned to this object.
ReportsToId	reference	Create Filter Nillable Update	This field is not visible if IsPersonAccount is `true`.
Salutation	picklist	Create Filter Nillable Update	Honorific abbreviation, word, or phrase to be used in front of name in greetings, such as Dr. or Mrs.
Title	string	Create Filter Nillable Update	Title of the contact such as CEO or Vice President.

Note

If you are importing Contact data into Salesforce.com 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. For more information, see System Fields.

Usage

Use this object to manage individuals who are associated with an Account in your organization. Client applications can use the API to create(), query(), delete(), update() any Attachment associated with a contact.

Client applications can also create or update contacts by converting a Lead via the convertLead() call. For more information, see convertLead().