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 

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

CanAllowPortalSelfReg 

  • Type: boolean
  • Properties: Create, Defaulted on create, Filter, Group, Sort, 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, Group, Nillable, Sort
  • 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, Group, Nillable, Sort
  • 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, 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.

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.

Email bounce functionality isn’t triggered by record updates, including updates to this field.

Note

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.

Email bounce functionality isn’t triggered by record updates, including updates to this field.

Note

Fax 

  • Type: phone
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The contact’s fax number. Label is Business Fax.

FirstCallDateTime 

  • Type: dateTime
  • Properties: Filter, Nillable, Sort
  • Description: The date and time of the first call placed to the contact. This field is available in API version 48.0 and later if you enabled Sales Engagement.

FirstEmailDateTime 

  • Type: dateTime
  • Properties: Filter, Nillable, Sort
  • Description: The date and time of the first email sent to the contact. This field is available in API version 48.0 and later if you enabled Sales Engagement.

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

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: Defaulted on create, 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, Group, Sort
  • 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 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

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.

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.

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 hasn’t been deleted, the value is null.

    This is a relationship field.

  • Relationship Name: MasterRecord

  • Relationship Type: Lookup

  • Refers To: Contact

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.

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.

    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.

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.

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.