Contact

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

Where possible, we changed noninclusive terms to align with our company value of Equality. We maintained certain terms to avoid any effect on customer implementations.

When importing contact data, users need the Set Audit Fields upon Record Creation permission to assign values to audit fields such as CreatedDate. Audit fields are automatically updated during API operations unless you set these fields yourself.

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

  • Customer Portal users can access only portal-enabled contacts.

  • 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: relationship

  • Refers to: Account

  • Type: reference
  • Properties: Filter, Group, Nillable, Sort
  • Introduced: API version 47.0
  • Description: The ID of the sales rep designated to work the lead through their assigned cadence. when the Sales Engagement license is enabled. To see this field, the user also needs the Sales Engagement User or Sales Engagement Quick Cadence Creator user permission set.
  • Relationship name: ActionCadenceAssignee
  • Relationship type: polymorphic
  • Refers to: Queue, User
  • Type: reference
  • Properties: Filter, Group, Nillable, Sort
  • Introduced: API version 45.0
  • Description: The ID of the lead’s assigned cadence. when the Sales Engagement license is enabled. To see this field, the user also needs the Sales Engagement User or Sales Engagement Quick Cadence Creator user permission set.
  • Relationship name: ActionCadence
  • Relationship type: relationship
  • Refers to: ActionCadence
  • Type: picklist
  • Properties: Filter, Group, Nillable, Restricted picklist, Sort
  • Introduced: API version 50.0
  • Description: The state of the current action cadence tracker. when the Sales Engagement license is enabled. To see this field, the user also needs the Sales Engagement User or Sales Engagement Quick Cadence Creator user permission set.
  • Possible values:
    • Complete — Complete
    • Error — Error
    • Initializing — Initializing
    • Paused — Paused
    • Processing — Processing
    • Running — Running
  • Type: int
  • Properties: Filter, Group, Nillable, Sort
  • Introduced: API version 57.0
  • Description: The number of cadences that are actively running on this contact. when the Sales Engagement license is enabled. To see this field, the user also needs the Sales Engagement User or Sales Engagement Quick Cadence Creator user permission set.

  • Type: reference

  • Properties: Filter, Group, Nillable, Sort

  • Introduced: API version 41.0

  • Description:

    When Einstein Activity Capture with Activity Metrics is enabled, the ID of the related activity metric.

    This field is a relationship field.

  • Relationship name: ActivityMetric

  • Relationship type: relationship

  • Refers to: ActivityMetric

  • Type: reference

  • Properties: Filter, Group, Nillable, Sort

  • Introduced: API version 41.0

  • Description:

    When Einstein Activity Capture with Activity Metrics is enabled, the ID of the related activity metric rollup.

    This field is a relationship field.

  • Relationship name: ActivityMetricRollup

  • Relationship type: relationship

  • Refers to: ActivityMetricRollup

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The assistant’s name.
  • Type: phone
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The assistant’s phone number. Label is Asst. Phone.

  • 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:

  • Type: multipicklist

  • Properties: Create, Filter, Nillable, Restricted picklist, Update

  • Introduced: API version 61.0

  • Description: If Automatic Contact Enhancements or Buyer Relationship Map is enabled, this field contains the role of the contact in the opportunity or account. Key values represent key contacts on an opportunity or account. If a buyer relationship map doesn’t have contacts with key values, then Salesforce prompts you to add them. Having all key values represented on the map provides a full view of the deal or account, increasing sales success.This field is available with all profiles except custom and minimum-access. To provide access, use field-level security in Object Manager.

  • Possible values:

    • BusinessUser — BusinessUser — For example, an end user. Key value.
    • Buyer — Buyer — Key value
    • Champion — Champion — Key value
    • DecisionMaker — DecisionMaker — Shown in green on a contact in the buyer relationship map UI. Key value.
    • Detractor — Detractor — Shown in red on a contact in the buyer relationship map UI. Key value.
    • Evaluator — Evaluator
    • ExecutiveSponsor — ExecutiveSponsor — Key value
    • TechnicalExpert — TechnicalExpert

    To ensure that the buyer relationship map feature works as expected, don’t modify field values. For example, if you change Detractor to Detract, the value isn’t shown in red in a buyer relationship map.
  • Type: boolean
  • Properties: Create, Defaulted on create, Filter, Group, Sort, Update
  • Introduced: API version 11.0
  • Description: Indicates whether this contact can self-register for your Customer Portal (true) or not (false).
  • Default value: false

  • Type: picklist

  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update

  • Introduced: API version 25.0

  • 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
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Introduced: API version 67.0
  • Description: The external Commerce ID of the individual. To update or create field values, you need the Manage Shopper Profile Sync System Fields user permission.
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Introduced: API version 67.0
  • Description: The external name of the Commerce customer group. To update or create field values, you need the Manage Shopper Profile Sync System Fields user permission.
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Introduced: API version 67.0
  • Description: The external organization ID of the Commerce instance. To update or create field values, you need the Manage Shopper Profile Sync System Fields user permission.
  • Type: reference
  • Properties: Filter, Group, Nillable, Sort
  • Introduced: API version 12.0
  • Description: ID of the PartnerNetworkConnection that shared this record with your organization. This field is available if you enabled Salesforce to Salesforce.
  • Relationship name: ConnectionReceived
  • Relationship type: relationship
  • Refers to: PartnerNetworkConnection
  • Type: reference
  • Properties: Filter, Group, Nillable, Sort
  • Introduced: API version 12.0
  • 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.
  • Relationship name: ConnectionSent
  • Relationship type: relationship
  • Refers to: PartnerNetworkConnection
  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
  • Introduced: API version 61.0
  • Description: If Automatic Contact Creation is enabled, this field indicates whether the contact was created automatically and identifies the source.
  • Possible values:
    • Auto Create — Auto Create
    • Email Message — Email Message
    • Meeting Digest — Meeting Digest
    • Seller Home — Seller Home
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The contact’s department.
  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
  • Introduced: API version 61.0
  • Description: If Automatic Contact Enhancements or Buyer Relationship Map is enabled, this field contains the business unit, function, or department that the contact belongs to in the organization. Key values represent key contacts on an opportunity or account. If a buyer relationship map doesn’t have contacts with key values, then Salesforce prompts you to add them. Having all key values represented on the map provides a full view of the deal or account, increasing sales success. This field is available with all profiles except custom and minimum-access. To provide access, use field-level security in Object Manager.
  • Possible values:
    • chiefExecutive — chiefExecutive — Key value
    • customerSuccess — customerSuccess — For example, wealth management, consumer banking, subject matter experts, or healthcare research experts.
    • finance — finance — Includes pricing and procurement. Key value.
    • humanResources — humanResources
    • legal — legal — Key value
    • marketing — marketing
    • other — other
    • sales — sales
    • support — support — For example, tech support or customer support.
    • tech — tech — For example, IT or engineering. Key value.
  • Type: textarea
  • Properties: Create, Nillable, Update
  • Description: A description of the contact. Label is Contact Description up to 32 KB.
  • Type: boolean
  • Properties: Create, Defaulted on create, Filter, Group, Sort, Update
  • Description: Indicates that the contact doesn’t want to receive calls.
  • Default value: false
  • Type: email
  • Properties: Create, Filter, Group, idLookup, Nillable, Sort, Update
  • Description: The contact’s email address.

  • Type: datetime

  • Properties: Create, Filter, Nillable, Sort, Update

  • Introduced: API version 13.0

  • Description: If bounce management is activated and an email sent to the contact results in a hard bounce, the date and time of the bounce.

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

  • Type: string

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Introduced: API version 13.0

  • Description: If bounce management is activated and an email sent to the contact results in a hard bounce, the reason for the bounce.

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

  • Type: reference

  • Properties: Filter, Group, Nillable, Sort

  • Relationship name: EngagementScore

  • Relationship type: relationship

  • Refers to: EngagementScore

  • Type: phone
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The contact’s fax number. Label is Business Fax.
  • Type: datetime
  • Properties: Filter, Nillable, Sort
  • Introduced: API version 48.0
  • Description: The date and time of the first call placed to the contact. when the Sales Engagement license is enabled. To see this field, the user also needs the Sales Engagement User or Sales Engagement Quick Cadence Creator user permission set.
  • Type: datetime
  • Properties: Filter, Nillable, Sort
  • Introduced: API version 48.0
  • Description: The date and time of the first email sent to the contact. when the Sales Engagement license is enabled. To see this field, the user also needs the Sales Engagement User or Sales Engagement Quick Cadence Creator user permission set.
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The contact’s first name up to 40 characters.
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
  • Introduced: API version 57.0
  • Description: The contact’s internal experience of their gender, which may or may not correspond to their designated sex at birth.
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Introduced: API version 42.0
  • 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.
  • Default value: false
  • Type: boolean
  • Properties: Create, Defaulted on create, Filter, Group, Sort, Update
  • Description: Indicates whether the contact prohibits receiving faxes.
  • Default value: false

  • Type: boolean

  • Properties: Defaulted on create, Filter, Group, Sort

  • Introduced: API version 57.0

  • Default value: false

  • Type: phone
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The contact’s home phone number. Label is Home Phone.

  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Introduced: API version 42.0

  • 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: relationship

  • Refers to: Individual

  • Type: string
  • Properties: Create, Nillable, Update
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Type: boolean
  • Properties: Defaulted on create, Filter, Group, Sort
  • Introduced: API version 29.0
  • Description: If bounce management is activated and an email is sent to a contact, indicates whether the email results in a soft or hard bounce (true) or not (false).
  • Default value: false
  • Type: boolean
  • Properties: Defaulted on create, Filter, Group, Sort
  • Introduced: API version 8.0
  • Description: Read only. Indicates whether this account has a record type of Person Account (true) or not (false). Label is Is Person Account.
  • Default value: false
  • Type: boolean
  • Properties: Defaulted on create, Group
  • Introduced: API version 59.0
  • Description: Shows whether the user has marked the contact as important (True) or not (False). The default value is false.
  • Default value: false

  • Type: string

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Introduced: API version 22.0

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

  • Type: string

  • Properties: Filter, Group, Nillable, Sort

  • Introduced: API version 23.0

  • Description: The ID of the contact in reference to Jigsaw.

    The Jigsaw field is exposed in the API to support troubleshooting for import errors and reimporting of corrected data. Don’t modify the value in the Jigsaw field.

  • 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.
  • Type: datetime
  • Properties: Filter, Nillable, Sort
  • Type: datetime
  • Properties: Filter, Nillable, Sort
  • Type: string
  • Properties: Create, Filter, Group, Sort, Update
  • Description: Required. Last name of the contact up to 80 characters.
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The source of the lead that was converted to this contact.
  • 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.
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Mailing address details.
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Mailing address details.
  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The ISO codes for the mailing address’s state and country.
  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
  • Description: Accuracy level of the geocode for the mailing address. For details on geolocation compound field, see .
  • 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 .
  • 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 .
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Mailing address details.
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Mailing address details.
  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The ISO codes for the mailing address’s state and country.
  • Type: textarea
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Street address for mailing address.

  • Type: reference

  • Properties: Filter, Group, Nillable, Sort

  • Introduced: API version 8.0

  • 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: relationship

  • Refers to: Contact

  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The contact’s middle name. Maximum size is 40 characters.
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Type: phone
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Contact’s mobile phone number. Label is Mobile Phone.
  • Type: string
  • Properties: Filter, Group, Sort
  • Description: Concatenation of FirstName, MiddleName, LastName, and Suffix up to 203 characters, including whitespaces.
  • 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.
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Alternate address details.
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Alternate address details.
  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The ISO codes for the alternate address’s state and country.
  • 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 .
  • 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 .
  • 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 .
  • Type: phone
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Phone for alternate address.
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Alternate address details.
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Alternate address details.
  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: The ISO codes for the alternate address’s state and country.
  • Type: textarea
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Street for alternate address.
  • Type: phone
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Phone number for the contact. Label is Business Phone.

  • Type: url

  • Properties: Filter, Group, Nillable, Sort

  • Introduced: API version 30.0

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

  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
  • Introduced: API version 57.0
  • 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.
  • Possible values:
    • He/Him — He/Him
    • He/They — He/They
    • Not Listed — Not Listed
    • She/Her — She/Her
    • She/They — She/They
    • They/Them — They/Them
  • Type: double
  • Properties: Create, Filter, Nillable, Sort, Update
  • Introduced: API version 62.0

  • Type: reference

  • Properties: Create, Filter, Group, Nillable, Sort, Update

  • Description:

    ID of the contact that this contact reports to.

    This is a relationship field.

  • Relationship name: ReportsTo

  • Relationship type: relationship

  • Refers to: Contact

  • 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.
  • Type: datetime
  • Properties: Filter, Nillable, Sort
  • Introduced: API version 54.0
  • Description: The date and time when the action cadence tracker is going to resume after it’s paused or on a wait step. when the Sales Engagement license is enabled. To see this field, the user also needs the Sales Engagement User or Sales Engagement Quick Cadence Creator user permission set.
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Name suffix of the contact. Maximum size is 40 characters.
  • Type: picklist
  • Properties: Filter, Group, Nillable, Restricted picklist, Sort
  • Introduced: API version 46.0
  • Type: string
  • Properties: Create, Filter, Group, Nillable, Sort, Update
  • Description: Title of the contact, such as CEO or Vice President.
  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
  • Introduced: API version 61.0
  • Description: If Automatic Contact Enhancements or Buyer Relationship Map is enabled, this field contains the hierarchical position that the contact holds in the organization. In the UI, this field is shown as Seniority Level. Key values represent key contacts on an opportunity or account. If a buyer relationship map doesn’t show contacts with key values, then Salesforce prompts you to add them. Having all key values represented on the map provides a complete picture of the deal or account, increasing sales success. This field is available with all profiles except custom and minimum-access. To provide access, use field-level security in Object Manager.
  • Possible values:
    • ceo — ceo — Key value
    • directorOrManager — directorOrManager — Key value
    • executive — executive — Key value
    • individualContributor — individualContributor
    • vp — vp — VP or Head of Department. Key value.
  • Type: picklist
  • Properties: Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
  • Introduced: API version 17.0

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.

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.