Newer Version Available

This content describes an older version of this product. View Latest

Prospect

Represents a prospect. A prospect is an individual who has shared contact information, but isn't yet qualified. This object is available in API version 63.0 and later.

Supported Calls

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

Fields

Field Details
Address
Type
address
Properties
Filter, Nillable
Description
Street address of the prospect. Up to 255 characters are allowed.
AnnualRevenue
Type
currency
Properties
Create, Filter, Nillable, Sort, Update
Description
The prospect company's yearly revenue.
City
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
City that's included in the prospect’s address.
Company
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The prospect's company.
ConvertedAccountId
Type
reference
Properties
Filter, Group, Nillable, Sort
Description
Object reference ID that points to the account into which the prospect converted.
This is a relationship field.
Relationship Name
ConvertedAccount
Refers To
Account
ConvertedContactId
Type
reference
Properties
Filter, Group, Nillable, Sort
Description
Object reference ID that points to the contact into which the prospect converted.
This is a relationship field.
Relationship Name
ConvertedContact
Refers To
Contact
ConvertedDate
Type
date
Properties
Filter, Group, Nillable, Sort
Description
Date on which this prospect was converted.
ConvertedLeadId
Type
reference
Properties
Filter, Group, Nillable, Sort
Description
Object reference ID that points to the lead into which the prospect has been converted.
This is a relationship field.
This field is a relationship field.
Relationship Name
ConvertedLead
Refers To
Lead
ConvertedOpportunityId
Type
reference
Properties
Filter, Group, Nillable, Sort
Description
Object reference ID that points to the opportunity into which the prospect has been converted.
This is a relationship field.
Relationship Name
ConvertedOpportunity
Refers To
Opportunity
Country
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The Prospect's country.
CurrencyIsoCode
Type
picklist
Properties
Create, Defaulted on create, Filter, Group, Restricted picklist, Sort, Update
Description
Available only for organizations with the multicurrency feature enabled. Contains the ISO code for any currency allowed by the organization.
Description
Type
textarea
Properties
Create, Nillable, Update
Description
The prospect’s description.
Email
Type
email
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The prospect's email address.
FirstName
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The prospect’s first name. Up to 40 characters allowed.
GenderIdentity
Type
picklist
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The prospect’s self-identified experience of their gender, which does or doesn’t correspond to the prospect’s designated sex at birth.
GeocodeAccuracy
Type
picklist
Properties
Create, Filter, Group, Nillable, Restricted picklist, Sort, Update
Description
Accuracy level of the geocode for the address. For details on geolocation compound fields, see Geolocation Compound Field.
Industry
Type
picklist
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Primary business of the prospect’s company
IsConverted
Type
boolean
Properties
Create, Defaulted on create, Filter, Group, Sort
Description
Indicates whether the prospect has been converted (true) or not (false). Label is Converted.
LastName
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Required. The Last name of the prospect. Up to 80 characters are allowed.
Latitude
Type
double
Properties
Create, Filter, Nillable, Sort, Update
Description
Used with Longitude to specify the precise geolocation of an 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.
LeadSource
Type
picklist
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The origin or source of the lead.
Longitude
Type
double
Properties
Create, Filter, Nillable, Sort, Update
Description
Used with Latitude to specify the precise geolocation of an 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.
Name
Type
string
Properties
Filter, Group, Nillable, Sort
Description
Concatenation of FirstName, MiddleName, LastName, and Suffix up to 203 characters, including whitespaces.
NumberOfEmployees
Type
int
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Number of employees at the prospect's company. Label is Employees.
Phone
Type
phone
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The prospect's phone number.
PostalCode
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Postal code that's included in the prospect's address. Label is Zip/Postal Code.
ProspectRecordName
Type
string
Properties
Filter, Group, idLookup, Sort
Description
The name of the prospect record used for managing prospects.
ProspectStatus
Type
picklist
Properties
Create, Defaulted on create, Filter, Group, Nillable, Sort, Update
Description
The status of the prospect.
Possible values are:
  • Contacted
  • New
  • Nurturing
  • Qualified
  • Unqualified
The default value is New.
Salutation
Type
picklist
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The prospect's preferred title.
Possible values are:
  • Dr.
  • Mr.
  • Mrs.
  • Ms.
  • Mx.
  • Prof.
State
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
State that's included in the prospect's address.
Street
Type
textarea
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
Street number or name that's included in the prospect's address.
Title
Type
string
Properties
Create, Filter, Group, Nillable, Sort, Update
Description
The prospect's business title, such as CFO or CEO. The maximum size is 128 characters. When converting a prospect to a person account, the conversion fails if the prospect Title field contains more than 80 characters.