Update a sales lead

patch

/crmRestApi/resources/11.13.18.05/leads/{leadsUniqID}

Request

Path Parameters
  • This is the hash key of the attributes which make up the composite key for the Sales Leads resource and used to uniquely identify an instance of Sales Leads. The client should not generate the hash key value. Instead, the client should query on the Sales Leads collection resource in order to navigate to a specific instance of Sales Leads to get the hash key.
Header Parameters
  • This header accepts a string value. The string is a semi-colon separated list of =. It is used to perform effective date range operations. The accepted parameters are RangeMode, RangeSpan, RangeStartDate, RangeEndDate, RangeStartSequence and RangeEndSequence. The parameter values are always strings. The possible values for RangeMode are SET_LOGICAL_START, SET_LOGICAL_END, END_DATE, SET_EFFECTIVE_START, SET_EFFECTIVE_END, REPLACE_CORRECTION, REPLACE_UPDATE, RECONCILE_CORRECTION, CORRECTION, RECONCILE_UPDATE, UPDATE, ZAP and DELETE_CHANGES. The possible values for RangeSpan are PHYSICAL_ROW_END_DATE and LOGICAL_ROW_END_DATE. The values for RangeStartDate and RangeEndDate have to be a string representation of a date in yyyy-MM-dd format. The value for RangeStartSequence and RangeEndSequence must be strings such that when parsed they yield positive integers.
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Supported Media Types
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
  • Title: Contact Address Attribute 1
    Maximum Length: 150
    The additional address element to support flexible address format.
  • Title: Contact Address Attribute 2
    Maximum Length: 150
    The additional address element to support flexible address format.
  • Title: Contact Address Attribute 3
    Maximum Length: 150
    The additional address element to support flexible address format.
  • Title: Contact Address Attribute 4
    Maximum Length: 150
    The additional address element to support flexible address format.
  • Title: Contact Address Attribute 5
    Maximum Length: 150
    The additional address element to support flexible address format.
  • Title: Contact Phonetic Address
    Maximum Length: 560
    The phonetic or kana representation of the Kanji address lines (used in Japan).
  • Sales Leads Attachments
    Title: Sales Leads Attachments
    The attachment resource is used to view, create, and update attachments of a sales lead. An attachment includes additional information about a sales lead.
  • Title: Registration Approval Date
    The date on which a partner registered lead is approved by internal channel manager.
  • Title: Registration Approval Date
    The date and time when the sales lead is approved. This is only applicable to deal registrations.
  • Lead Qualifications
    Title: Lead Qualifications
    The assessments resource is used to view, create and update qualifications of a lead.
  • Title: Asset ID
    The unique identifier of the asset associated with the sales lead.
  • Title: Asset Number
    Maximum Length: 100
    The alternate key identifier of the asset associated with the sales lead.
  • Title: Assignment Status
    Maximum Length: 30
    The code indicating the current assignment related status for the lead, for example whether the lead is assigned or unassigned.
  • Title: Budget Amount
    The budget amount associated with this sales lead.
  • Title: Budget Currency
    Maximum Length: 80
    The currency code associated with the Budget Amount. This attribute is used by CRM Extensibility framework. A list of accepted values is defined in the lookup ZCA_COMMON_CORPORATE_CURRENCY. Review and update the profile option using the Setup and Maintenance work area, Manage Trading Community Common Lookups task.
  • Title: Budget Status
    Maximum Length: 120
    The budget status associated with the Budget Amount.
  • Title: Building
    Maximum Length: 40
    The specific building name or number at a given address.
  • Title: Source
    Maximum Length: 30
    The channel through which a lead contacted the company.
  • Title: Industry Classification Code
    Maximum Length: 30
    The auxiliary dimension for the Account.
  • Title: Auxiliary Classification Code 1
    Maximum Length: 30
    The auxiliary dimension for the Account.
  • Title: Auxiliary Classification Code 2
    Maximum Length: 30
    The auxiliary dimension for the Account.
  • Title: Auxiliary Classification Code 3
    Maximum Length: 30
    The auxiliary dimension for the Account.
  • Title: Conflict Identifier
    Default Value: 1
    The value guarantees the uniqueness of the row when duplicates are created in different databases such as mobile databases, or the server.
  • Title: Don't Contact Preference
    Maximum Length: 30
    Indicates the don't contact preference of the sales lead.
  • Title: Contact Time Zone
    Maximum Length: 35
    The preferred time zone of the contact pursued on the lead.
  • Title: Converted Date
    The date and time when the sales lead is converted to an opportunity.
  • Title: Currency
    Maximum Length: 15
    The currency code associated with the lead. This attribute is used by CRM Extensibility framework. A list of accepted values is defined in the lookup ZCA_COMMON_CORPORATE_CURRENCY. Review and update the profile option using the Setup and Maintenance work area, Manage Trading Community Common Lookups task.
  • Title: Customer ID
    The unique identifier of the Customer. It is a reference to the customer record in the TCA schema.
  • Title: Customer Need
    Maximum Length: 30
    The need the lead product serves for the lead customer.
  • Title: Account Name
    Maximum Length: 360
    The name of the customer.
  • Title: Deal Size
    The total amount attributed to a lead.
  • Title: Decision Maker Identified
    Maximum Length: 120
    Default Value: false
    Indicates if the decision maker at customer site has been identified.
  • Title: Description
    Maximum Length: 2000
    The description of a sales lead.
  • Title: Eligible for Conversion
    Maximum Length: 1
    Specifies whether the lead is eligible for conversion to opportunity.
  • Title: Create Account
    Maximum Length: 1
    Indicates whether new account should be created during lead conversion.
  • Title: Create Contact
    Maximum Length: 1
    Indicates whether new contact should be created during lead conversion.
  • Title: Estimated Close Date
    The date when a registered deal is expected to close.
  • Title: Expiration Date
    The date when a sales lead will expire.
  • Title: Contact Address Floor Number
    Maximum Length: 40
    The specific floor number at a given address or in a particular building when building number is provided.
  • Title: Next Follow-up Date
    Indicates when the sales lead needs to be followed up.
  • Title: Installed Base Asset
    The unique identifier for the IB asset associated with the sales lead.
  • Interviews
    Title: Interviews
    The interviews resource is used to view and delete an interview record.
  • Title: Product Item
    Maximum Length: 240
    The description of the product added to a lead.
  • Title: Job Title
    Maximum Length: 100
    The job title of the sales lead contact.
  • Title: Last Automatic Assignment Date
    The date on which the lead was last reassigned.
  • Title: Latitude
    The latitude information for the lead address. The latitude information for the location is used for spatial proximity and containment purposes.
  • Title: Accepted
    Maximum Length: 4
    Indicates if the lead has been accepted.
  • Lead Campaigns
    Title: Lead Campaigns
    The lead campaign resource is used to view, create, update, and delete the association of a campaign with a lead.
  • Sales Lead Competitors
    Title: Sales Lead Competitors
    The lead competitors resource is used to view, create, update, and delete the association of a campaign with a lead.
  • Title: Lead Identifier
    The unique identifier of the sales lead.
  • Title: Lead Last Update Date
    The date when the lead record was last updated.
  • Title: Lead Last Updated By
    Maximum Length: 64
    The user who last updated the lead record.
  • Opportunities
    Title: Opportunities
    The opportunity resource is used to view, create, or modify an opportunity generated from a lead. An opportunity list associated with the lead represents leads that have already been converted to the list of opportunities.
  • Lead Rollups
    Title: Lead Rollups
    The lead rollups resource is used to view a sales lead rollup.
  • Lead Score Details
    Title: Lead Score Details
    The lead score details resource is used to view the details of lead conversion probability.
  • Title: Longitude
    The longitude information for the lead address. The longitude information for the location is used for spatial proximity and containment purposes.
  • Sales Lead Resources
    Title: Sales Lead Resources
    The sales lead resources data object (resource) is used to capture a resource associated with the sales lead team. A lead resource is a business object that is used to represent resources who are team members that form part of the lead sales team.
  • Sales Lead Contacts
    Title: Sales Lead Contacts
    The sales lead contacts resource is used to capture a contact associated with the sales lead.
  • Lead Team
    Title: Lead Team
    The lead teams resource is used to view the team members and territory team members associated with a lead.
  • Sales Lead Territories
    Title: Sales Lead Territories
    The sales lead territories resource is used to view the associated sales lead territories.
  • Sales Lead Products
    Title: Sales Lead Products
    The sales lead products resource is used to capture a product associated with the sales lead.
  • Title: Lead Name
    Maximum Length: 250
    The name of the lead.
  • Notes
    Title: Notes
    The note resource is used to capture comments, information, or instructions for a sales lead.
  • Title: Opportunity Name
    The name of the opportunity created from converting the lead.
  • Title: Opportunity Owner Number
    The alternate identifier for the owner of the opportunity created from converting the lead.
  • Orchestration Associations
    Title: Orchestration Associations
    The orchestrations associations resource is used to view, create, update, and delete an orchestration association.
  • Title: Organization Size
    Maximum Length: 30
    The size of the Organization.
  • Title: Organization Type
    Maximum Length: 30
    The type of the Organization.
  • Title: Owner ID
    The unique party identifier associated with the owner of this sales lead.
  • Title: Owner
    Maximum Length: 360
    The name of the owner of a sales lead.
  • Title: Primary Partner Identifier
    The unique identifier of the primary partner associated with the lead.
  • Title: Primary Partner
    The name of the partner associated with the sales lead.
  • Title: Partner Program
    The unique identifier for the partner program in which the primary partner associated with this sales lead is enrolled. This is a deal specific attribute.
  • Title: Partner Type
    Maximum Length: 30
    The type of the primary partner associated with this sales lead. This is a deal specific attribute.
  • Title: Postal Code
    Maximum Length: 10
    The four digit extension to the United States Postal ZIP code.
  • Title: Primary Campaign ID
    The unique identifier of the primary campaign of the Lead. It is a reference key to campaign object.
  • Title: Primary Campaign
    The name of the primary campaign of the lead.
  • Title: Primary Campaign Number
    Maximum Length: 30
    The alternate identifier for primary campaign of the lead.
  • Title: Primary Competitor
    The name of the primary competitor of the lead.
  • Title: Primary Competitor Party ID
    The unique identifier of the primary competitor of the lead. It is a reference key to competitor object.
  • Title: Primary Contact Address 1
    Maximum Length: 240
    The first line of address associated with the primary contact of the lead.
  • Title: Primary Contact Address 2
    Maximum Length: 240
    The second line of address associated with the primary contact of the lead.
  • Title: Primary Contact Address 3
    Maximum Length: 240
    The third line of address associated with the primary contact of the lead.
  • Title: Primary Contact Address 4
    Maximum Length: 240
    The fourth line of address associated with the primary contact of the lead.
  • Title: Primary Contact City
    Maximum Length: 60
    The city where the primary contact of the lead is located.
  • Title: Country
    Maximum Length: 2
    The country where the primary contact of the lead is located.
  • Title: Primary Contact County
    Maximum Length: 60
    The county where the primary contact of the lead is located.
  • Title: Contact Email
    Maximum Length: 320
    The Email address for the primary sales lead contact on the lead.
  • Title: Email Preference
    Maximum Length: 30
    Indicates if the user can e-mail the lead or not. If the value is True, then the user must not contact the person by e-mail. The default value is False. A list of accepted values is defined using the lookup YES_NO. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Common Lookups task.
  • Title: Email Verification Date
    The verification date for primary contact email address.
  • Title: Email Verification Status
    Maximum Length: 30
    The verification status for primary contact email address.
  • Title: Primary Contact ID
    The unique identifier of the sales lead contact marked as a primary lead contact.
  • Title: Mail Preference
    Maximum Length: 30
    Indicates if the user can send mail to the lead or not. If the value is True, then the user must not contact the person by mail. The default value is False. A list of accepted values is defined using the lookup YES_NO. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Common Lookups task.
  • Title: Primary Contact Name
    Maximum Length: 450
    The name associated with the primary lead contact.
  • Title: Primary Contact First Name
    Maximum Length: 150
    The first name of the primary contact for a lead.
  • Title: Primary Contact Last Name
    Maximum Length: 150
    The last name of the primary contact for a lead.
  • Title: Primary Contact Middle Name
    Maximum Length: 150
    The middle name of the primary contact for a lead.
  • Title: Phone Preference
    Maximum Length: 30
    Indicates if the user can contact the lead or not by phone, e-mail, or mail. If the value is True, then the user must not contact the person. The default value is False. A list of accepted values is defined using the lookup YES_NO. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Common Lookups task.
  • Title: Primary Contact Postal Code
    Maximum Length: 60
    The zip code where the primary contact of the lead is located.
  • Title: Primary Contact Province
    Maximum Length: 60
    The province where the primary contact of the lead is located.
  • Title: Primary Contact Relationship ID
    The unique identifier of the relationship primary contact has with its parent organization.
  • Title: Primary Contact State
    Maximum Length: 60
    The state where the primary contact of the lead is located.
  • Title: Primary Product ID
    The unique identifier of the primary product associated with a lead.
  • Title: Primary Product Organization ID
    The unique identifier of the organization to which the primary product associated with a lead belongs.
  • Title: Primary Phone Area Code
    Maximum Length: 10
    The primary phone area code for the sales lead contact.
  • Title: Primary Phone Country Code
    Maximum Length: 10
    The primary phone country code for the sales lead contact.
  • Title: Contact Phone
    Maximum Length: 40
    The primary phone number for the sales lead contact.
  • Title: Primary Phone Verification Date
    The verification date for lead primary phone.
  • Title: Primary Phone Verification Status
    Maximum Length: 30
    The verification status for lead primary phone.
  • Title: Primary Product Group ID
    The unique identifier of the primary product group associated with a lead.
  • Title: Primary Product Group Reference Number
    Maximum Length: 50
    The alternate key for the referenced primary product group.
  • Title: Product Group
    Maximum Length: 250
    The name of the product group if this record represents a product group.
  • Product Groups
    Title: Product Groups
    The product groups resource is used to capture the name of the product group associated with the sales lead. A product group is a business object that groups related products, so that you can work with them together. You can use product groups to create a multilevel hierarchy that can be used as a sales catalog, a rollup hierarchy, or a promotion catalog. For example, you might create a product group named Consumer Electronics that includes all of your consumer electronics products so that customers can browse through all the products in this group in your product catalog.
  • Products
    Title: Products
    The product resource is used to capture the name of the product associated with the sales lead.
  • Title: Product Type
    The type of the primary product, such as item or product group.
  • Title: Partner Program
    The name of the partner program in which the primary partner associated with this sales lead is enrolled. This is a deal specific attribute.
  • Title: Customer Project
    Maximum Length: 30
    The customer project identified for this sales lead.
  • Title: Qualification Date
    The date when this sales lead was qualified.
  • Title: Qualification Date
    The date and time when the sales lead is qualified.
  • Title: Rank
    Maximum Length: 30
    The rank associated with this sales lead.
  • Title: Raw Phone Number
    The raw value of the lead primary phone number.
  • Title: Reassign Comments
    Maximum Length: 1000
    The comment provided by a user while requesting the lead reassignment.
  • Title: Reassign Reason
    Maximum Length: 30
    The code indicating the reason for reassigning the lead. A list of valid values is defined in the lookup ReassignVA.
  • Title: Registration Number
    Maximum Length: 120
    The registration number of the sales lead. This unique identifier is generated when the sales lead is approved. This is a deal specific attribute.
  • Title: Registration Status
    Maximum Length: 120
    The approval Status of the sales lead. This is a deal specific attribute.
  • Title: Registration Type
    Maximum Length: 120
    The registration type of the sales lead. This is a deal specific attribute.
  • Title: Reject by User ID
    The unique identifier of the sales representative who rejected this sales lead.
  • Title: Rejection Comments
    Maximum Length: 250
    The comments provided by the sales representative who rejected this sales lead.
  • Title: Rejected Time Stamp
    The date and time when the sales lead is rejected.
  • Title: Reject Reason
    Maximum Length: 30
    The code indicating the reason for rejecting the lead. A list of valid values is defined in the lookup RejectReasonVA.
  • Title: Retirement Comments
    Maximum Length: 250
    The comments recorded when the sales lead is moved to a retired status.
  • Title: Retired Time Stamp
    The date and time when the sales lead is moved to a retired status.
  • Title: Retire Reason
    Maximum Length: 30
    The code indicating the reason for retiring the lead. A list of valid values is defined in the lookup RetireReasonVA.
  • Title: Sales Channel
    Maximum Length: 120
    The sales channel responsible for following up on this sales lead.
  • Sales Contents
    Title: Sales Contents
    The sales contents resource is used to view, create, update, and delete the sales content associated with a lead.
  • Title: Last Sync to Marketing Date
    The date on which the current sales target lead contacts are last synced to Eloqua.
  • Title: Opt-out Comment
    Maximum Length: 1000
    The comments provided by the sales representative who opted out this lead.
  • Title: Opt-out Date
    The date of opting out the lead from sales target campaign.
  • Title: Opt-out Reason
    Maximum Length: 32
    The reason for opting out the lead from sales target campaign.
  • Title: Stage
    Maximum Length: 32
    The lead's current stage in the account based selling process.
  • Title: Validation Due Date
    The date on which the sales target lead validation is due.
  • Title: Score
    The score associated with this sales lead. This score is computed based on the scoring rules.
  • Smart Actions
    Title: Smart Actions
    The smart actions resource is used to view the name, security, context object, REST operation, confirmation message, and other global properties of smart actions. Smart action item or collection links returned in response payloads are valid at the moment the REST request is processed. Any change to the parent object context can invalidate a previously valid smart action.
  • Title: Source Code
    Maximum Length: 30
    The marketing source code associated with this sales lead.
  • Marketing Source Codes
    Title: Marketing Source Codes
    The marketing source code resource is used to track responses and leads generated by each sales and marketing campaigns, and helps gauge the effectiveness of each initiative. A marketing source code is a unique identifier representing a marketing campaign and the underlying treatment and segment or list used within each execution.
  • Title: Status
    Maximum Length: 30
    Default Value: UNQUALIFIED
    The code indicates the current status of the lead. A list of valid values is defined in the lookup StatusCodeVA.
  • Title: Time Frame
    Maximum Length: 120
    The timeframe associated with this sales lead.
  • Title: Reassign
    Maximum Length: 1
    Default Value: false
    Indicates leads that are either unassigned or have been selected for automatic reassignment.
  • Title: Work Phone Area Code
    Maximum Length: 10
    The area code of the work phone associated with the sales lead contact.
  • Title: Work Phone Country Code
    Maximum Length: 10
    The country code of the work phone associated with the sales lead contact.
  • Title: Work Phone Number
    Maximum Length: 40
    The work phone number of the sales lead contact.
Nested Schema : Sales Leads Attachments
Type: array
Title: Sales Leads Attachments
The attachment resource is used to view, create, and update attachments of a sales lead. An attachment includes additional information about a sales lead.
Show Source
Nested Schema : Lead Qualifications
Type: array
Title: Lead Qualifications
The assessments resource is used to view, create and update qualifications of a lead.
Show Source
Nested Schema : Interviews
Type: array
Title: Interviews
The interviews resource is used to view and delete an interview record.
Show Source
Nested Schema : Lead Campaigns
Type: array
Title: Lead Campaigns
The lead campaign resource is used to view, create, update, and delete the association of a campaign with a lead.
Show Source
Nested Schema : Sales Lead Competitors
Type: array
Title: Sales Lead Competitors
The lead competitors resource is used to view, create, update, and delete the association of a campaign with a lead.
Show Source
Nested Schema : Opportunities
Type: array
Title: Opportunities
The opportunity resource is used to view, create, or modify an opportunity generated from a lead. An opportunity list associated with the lead represents leads that have already been converted to the list of opportunities.
Show Source
Nested Schema : Lead Rollups
Type: array
Title: Lead Rollups
The lead rollups resource is used to view a sales lead rollup.
Show Source
Nested Schema : Lead Score Details
Type: array
Title: Lead Score Details
The lead score details resource is used to view the details of lead conversion probability.
Show Source
Nested Schema : Sales Lead Resources
Type: array
Title: Sales Lead Resources
The sales lead resources data object (resource) is used to capture a resource associated with the sales lead team. A lead resource is a business object that is used to represent resources who are team members that form part of the lead sales team.
Show Source
Nested Schema : Sales Lead Contacts
Type: array
Title: Sales Lead Contacts
The sales lead contacts resource is used to capture a contact associated with the sales lead.
Show Source
Nested Schema : Lead Team
Type: array
Title: Lead Team
The lead teams resource is used to view the team members and territory team members associated with a lead.
Show Source
Nested Schema : Sales Lead Territories
Type: array
Title: Sales Lead Territories
The sales lead territories resource is used to view the associated sales lead territories.
Show Source
Nested Schema : Sales Lead Products
Type: array
Title: Sales Lead Products
The sales lead products resource is used to capture a product associated with the sales lead.
Show Source
Nested Schema : Notes
Type: array
Title: Notes
The note resource is used to capture comments, information, or instructions for a sales lead.
Show Source
Nested Schema : Orchestration Associations
Type: array
Title: Orchestration Associations
The orchestrations associations resource is used to view, create, update, and delete an orchestration association.
Show Source
Nested Schema : Product Groups
Type: array
Title: Product Groups
The product groups resource is used to capture the name of the product group associated with the sales lead. A product group is a business object that groups related products, so that you can work with them together. You can use product groups to create a multilevel hierarchy that can be used as a sales catalog, a rollup hierarchy, or a promotion catalog. For example, you might create a product group named Consumer Electronics that includes all of your consumer electronics products so that customers can browse through all the products in this group in your product catalog.
Show Source
Nested Schema : Products
Type: array
Title: Products
The product resource is used to capture the name of the product associated with the sales lead.
Show Source
Nested Schema : Sales Contents
Type: array
Title: Sales Contents
The sales contents resource is used to view, create, update, and delete the sales content associated with a lead.
Show Source
Nested Schema : Smart Actions
Type: array
Title: Smart Actions
The smart actions resource is used to view the name, security, context object, REST operation, confirmation message, and other global properties of smart actions. Smart action item or collection links returned in response payloads are valid at the moment the REST request is processed. Any change to the parent object context can invalidate a previously valid smart action.
Show Source
Nested Schema : Marketing Source Codes
Type: array
Title: Marketing Source Codes
The marketing source code resource is used to track responses and leads generated by each sales and marketing campaigns, and helps gauge the effectiveness of each initiative. A marketing source code is a unique identifier representing a marketing campaign and the underlying treatment and segment or list used within each execution.
Show Source
Nested Schema : schema
Type: object
Show Source
Nested Schema : leads-Assessments-item-patch-request
Type: object
Show Source
Nested Schema : Assessment Answer Groups
Type: array
Title: Assessment Answer Groups
The assessment answer groups resource is used to view question groups in an assessment.
Show Source
Nested Schema : leads-Assessments-AssessAnswerGroups-item-patch-request
Type: object
Show Source
Nested Schema : AssessmentAnswer
Type: array
Show Source
Nested Schema : leads-Assessments-AssessAnswerGroups-AssessmentAnswer-item-patch-request
Type: object
Show Source
Nested Schema : leads-Interviews-item-patch-request
Type: object
Show Source
Nested Schema : leads-LeadCampaigns-item-patch-request
Type: object
Show Source
Nested Schema : leads-LeadCompetitors-item-patch-request
Type: object
Show Source
  • Title: Comments
    Maximum Length: 2000
    Indicates the comments of the competitor associated with the lead.
  • Title: PrimaryFlag
    Indicates whether the competitor is a primary for the lead.
  • Title: Threat Level Code
    Maximum Length: 30
    Indicates the threat level of the competitor associated with the lead.
Nested Schema : leads-LeadOpportunity-item-patch-request
Type: object
Show Source
Nested Schema : leads-LeadRollup-item-patch-request
Type: object
Show Source
Nested Schema : leads-leadScoreDetails-item-patch-request
Type: object
Show Source
Nested Schema : leads-MklLeadResources-item-patch-request
Type: object
Show Source
  • Title: Access
    Maximum Length: 30
    Default Value: FULL
    The code indicating the access level of a team member.
  • Title: Conflict Identifier
    Default Value: 1
    The value guarantees the uniqueness of the row when duplicates are created in different databases such as mobile databases, or the server.
  • Title: Function
    Maximum Length: 30
    The role played by this Sale team resource for the handling of this sales lead.
  • Title: Lead Resource ID
    The unique identifier of the sales lead resource.
  • Title: Primary
    Maximum Length: 1
    Default Value: false
    Indicates whether the record represents the primary resource on the lead. The primary resource on the lead is the same as the lead owner.
  • Title: Resource ID
    The unique identifier associated with this sales lead resource.
Nested Schema : leads-MklLeadTcMembers1-item-patch-request
Type: object
Show Source
  • Title: Conflict Identifier
    Default Value: 0
    The value guarantees the uniqueness of the row when duplicates are created in different databases such as mobile databases, or the server.
  • Title: Job Title
    The label displaying the job title of a contact in his company.
  • Title: Email
    The e-mail address associated with the sales lead contact.
  • Title: Phone
    The formatted phone number of the lead contact.
  • Title: Lead Contact ID
    The unique identifier for the sales lead contact.
  • Title: Contact Party ID
    The unique identifier of the lead to which the contact is associated.
  • Title: Party Usage Code
    Maximum Length: 30
    The party usage recorded for this lead contact in the customer master.
  • Title: Primary
    Maximum Length: 1
    Indicates whether a lead contact is the primary contact. The primary lead contact is also the lead owner.
  • Title: Relationship ID
    The unique relationship identifier for this lead contact. This represents the relation of this lead contact with lead customer.
  • Title: Function
    Maximum Length: 30
    The role of lead contact in the context of this lead.
Nested Schema : leads-MklLeadTeam-item-patch-request
Type: object
Show Source
Nested Schema : leads-MklLeadTerritoryAssoc-item-patch-request
Type: object
Show Source
Nested Schema : leads-MklProdAssoc1-item-patch-request
Type: object
Show Source
  • Title: Amount
    The amount associated with the sales lead product.
  • Title: Average Time to Close
    The average time to close for this sales lead product.
  • Title: Conflict Identifier
    Default Value: 0
    The value guarantees the uniqueness of the row when duplicates are created in different databases such as mobile databases, or the server.
  • Title: Currency
    Maximum Length: 15
    The currency code associated with the lead product line amount. A list of accepted values is defined in the lookup ZCA_COMMON_CORPORATE_CURRENCY. You can review and update the value for this attribute using the Setup and Maintenance work area, Manage Trading Community Common Lookups task.
  • Title: Item Description
    Maximum Length: 240
    The product description where the product is associated with the lead.
  • Title: Estimated Unit Price
    The estimated unit price for this lead product.
  • Title: Inventory Number
    The unique inventory item identifier associated with the lead product.
  • Title: Lead Product ID
    The unique identifier of the current sales lead product.
  • Title: Organization
    The unique inventory organization identifier associated with this lead product.
  • Title: Primary
    Maximum Length: 1
    Indicates whether this product is a primary product for this lead.
  • Title: Product Group ID
    The unique identifier of the product group.
  • Title: Product Group Name
    Maximum Length: 250
    The name of the product group associated with the sales lead product resource.
  • Title: Product Group Reference Number
    Maximum Length: 50
    The alternate key for referenced product group.
  • Title: Product Type
    The type of the product, such as item or product group.
  • Title: Quantity
    The product quantity identified for this product on the lead.
  • Title: UOM
    Maximum Length: 3
    The unit of measure associated with this sales lead product line.
Nested Schema : leads-Note-item-patch-request
Type: object
Show Source
  • Title: Contact Relationship ID
    The unique identifier of the relationship populated when the note is associated with a sales lead contact.
  • Title: Corporate Currency Code
    Maximum Length: 15
    The corporate currency code of the note associated with the sales lead. A list of accepted values is defined in the lookup ZCA_COMMON_CORPORATE_CURRENCY. Review and update the profile option using the Setup and Maintenance work area, Manage Trading Community Common Lookups task.
  • Title: Creator Party ID
    The unique party identifier of the note creator.
  • Title: Currency Conversion Rate Type
    Maximum Length: 30
    The currency conversion rate type associated with the note. A list of accepted values is defined in the lookup ZCA_COMMON_RATE_TYPE. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Trading Community Common Lookups task.
  • Title: Currency
    Maximum Length: 15
    The currency code associated with the note. A list of accepted values is defined in the lookup ZCA_COMMON_CORPORATE_CURRENCY. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Trading Community Common Lookups task.
  • Title: Title
    Maximum Length: 500
    The user provided title for the note.
  • Title: Note
    The column which stores the actual note text.
  • Title: Type
    Maximum Length: 30
    The code indicating the type of the note. A list of valid values defined in the lookup NoteSourceTypeVA.
  • Title: Related Object
    Maximum Length: 64
    The primary key identifier of the source object such as Activities, Opportunities, as defined in OBJECTS Metadata.
  • Title: Private
    Maximum Length: 30
    Default Value: INTERNAL
    The code indicating the visibility level of the note, such as internal or external.
Nested Schema : leads-OrchestrationAssociations-item-patch-request
Type: object
Show Source
Nested Schema : Error Logs
Type: array
Title: Error Logs
The error logs resource is used to view error logs associated to the orchestration associations.
Show Source
Nested Schema : Stage Objectives
Type: array
Title: Stage Objectives
The stage objectives resource is used to view the stage objectives of the orchestration association.
Show Source
Nested Schema : Stages
Type: array
Title: Stages
The stages resource is used to view the stage of the orchestration association.
Show Source
Nested Schema : Steps
Type: array
Title: Steps
The steps resource is used to view the steps of the orchestration association.
Show Source
Nested Schema : Steps In Execution Path
Type: array
Title: Steps In Execution Path
The steps in execution path resource is used to view all the steps including future steps of the orchestration association.
Show Source
Nested Schema : Step Transitions
Type: array
Title: Step Transitions
The step transitions resource is used to view the step transitions of the orchestration association.
Show Source
Nested Schema : leads-OrchestrationAssociations-ErrorLogs-item-patch-request
Type: object
Show Source
Nested Schema : leads-OrchestrationAssociations-StageObjectives-item-patch-request
Type: object
Show Source
  • Title: Display Sequence
    The order in which the Stages to be executed or displayed in the User Interface.
  • Title: Run Time Status
    Maximum Length: 30
    The status of the orchestration stage objective transition.
Nested Schema : leads-OrchestrationAssociations-Stages-item-patch-request
Type: object
Show Source
Nested Schema : leads-OrchestrationAssociations-Steps-item-patch-request
Type: object
Show Source
Nested Schema : leads-OrchestrationAssociations-StepsInExecutionPath-item-patch-request
Type: object
Show Source
Nested Schema : leads-OrchestrationAssociations-StepTransitions-item-patch-request
Type: object
Show Source
Nested Schema : leads-productGroups-item-patch-request
Type: object
Show Source
Nested Schema : leads-products-item-patch-request
Type: object
Show Source
  • Title: Keyword
    The text or keywords associated with the product.
Nested Schema : leads-SalesContents-item-patch-request
Type: object
Show Source
Nested Schema : leads-smartActions-item-patch-request
Type: object
Show Source
Nested Schema : Smart Action User Interface Definitions
Type: array
Title: Smart Action User Interface Definitions
UI navigation metadata striped by app usage.
Show Source
Nested Schema : Smart Action REST Payload Definitions
Type: array
Title: Smart Action REST Payload Definitions
If an LOV required for constructing a request payload needs to post data, the payload metadata is stored here.
Show Source
Nested Schema : Smart Action User Interface Definitions
Type: array
Title: Smart Action User Interface Definitions
Binding metadata for a variable in the URL.
Show Source
Nested Schema : leads-smartActions-UserActionNavigation-item-patch-request
Type: object
Show Source
  • Title: System Action
    Maximum Length: 1
    Default Value: false
    The system assigned value indicating whether the smart action is seeded or custom. 'True' indicates the smart action is seeded. The value is automatically derived from smartActions.SystemActionFlag.
  • Title: Application Usage
    Maximum Length: 50
    The client application associated with a smart action user interface endpoint definition identified by UserActionNavId.
  • Title: Navigation Metadata
    Maximum Length: 1000
    The metadata definition of the smart action user interface endpoint.
  • Title: Navigation Type
    Maximum Length: 100
    The text value used by applications to determine which user interface to launch.
Nested Schema : leads-smartActions-UserActionRequestPayload-item-patch-request
Type: object
Show Source
  • Title: Payload Value Binding Type
    Maximum Length: 64
    The classification of the value property of a name-value pair. A binding value of RUNTIME indicates the value to be assigned is the runtime value of an object attribute. A value of STATIC indicates the value to be assigned is a simple string. A null value indicates that the value type is JSON_ARRAY_STRING.
  • Title: Mandatory
    Maximum Length: 1
    Indicates whether a REST payload body parameter value is mandatory. If True, runtime validation ensures that the value is defined.
  • Title: Request Payload Attribute Name
    Maximum Length: 256
    The value assigned to the name property of a name-value pair.
  • Title: Smart Suggest Path
    Maximum Length: 2048
    The path used for smart suggest.
  • Title: System Action
    Maximum Length: 1
    Default Value: false
    The system assigned value indicating whether the smart action is seeded or custom. 'True' indicates the smart action is seeded. The value is automatically derived from smartActions.SystemActionFlag.
  • Title: Request Payload Attribute Value
    Maximum Length: 1000
    The value assigned to the value property of a name-value pair.
  • Title: Payload Value Structure
    Maximum Length: 20
    A value of JSON_ARRAY_STRING indicates that the value property of a name-value pair represents an array of data rather than a single entity such as an object attribute name or simple text string. The array string is a definition of the name-value pair and the Binding and Mandatory properties. The array string follows specific pattern, for example [{"name":"leadId","Value":"LeadId","MandatoryFlag":true,"Binding":"RUNTIME"}]. A null value indicates the value property represents a simple, single entity such as an object attribute name or simple text string.
Nested Schema : leads-smartActions-UserActionURLBinding-item-patch-request
Type: object
Show Source
  • Title: URL Binding Type
    Maximum Length: 64
    The classification of the value property of a name-value pair. The binding value of a UserActionURLBinding instance must be RUNTIME. A binding value of RUNTIME indicates the value to be assigned is the runtime value of an object attribute.
  • Title: System Action
    Maximum Length: 1
    Default Value: false
    The system assigned value indicating whether the smart action is seeded or custom. 'True' indicates the smart action is seeded. The value is automatically derived from smartActions.SystemActionFlag.
  • Title: URL Binding Parameter Name
    Maximum Length: 50
    The value assigned to the name property of a name-value pair.
  • Title: URL Binding Parameter Value
    Maximum Length: 80
    The value assigned to the value property of a name-value pair.
Nested Schema : leads-sourceCodes-item-patch-request
Type: object
Show Source
  • Title: Active
    Maximum Length: 1
    Default Value: true
    Indicates an active or inactive status of this source code.
  • Title: Campaign ID
    The unique identifier of the campaign associated with this source code.
  • Title: Object Version Number
    Used to implement optimistic locking. This number is incremented every time that the row is updated. The number is compared at the start and end of a transaction to detect whether another session has updated the row since it was queried.
  • Title: Source Code ID
    The unique identifier of the source code.
Back to Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
  • The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Body ()
Root Schema : leads-item-response
Type: object
Show Source
  • Title: Accepted Date
    Read Only: true
    The date on which lead was accepted by a resource assigned to it.
  • Title: Accepted Date
    Read Only: true
    The date and time when the sales lead is accepted by a resource assigned to it.
  • Title: Account Number
    Read Only: true
    Maximum Length: 30
    The account number alternate key for referenced customer.
  • Title: Contact Address Attribute 1
    Maximum Length: 150
    The additional address element to support flexible address format.
  • Title: Contact Address Attribute 2
    Maximum Length: 150
    The additional address element to support flexible address format.
  • Title: Contact Address Attribute 3
    Maximum Length: 150
    The additional address element to support flexible address format.
  • Title: Contact Address Attribute 4
    Maximum Length: 150
    The additional address element to support flexible address format.
  • Title: Contact Address Attribute 5
    Maximum Length: 150
    The additional address element to support flexible address format.
  • Title: Contact Phonetic Address
    Maximum Length: 560
    The phonetic or kana representation of the Kanji address lines (used in Japan).
  • Title: AI Lead Score
    Read Only: true
    The AI calculated probability of the lead being converted to an opportunity.
  • Sales Leads Attachments
    Title: Sales Leads Attachments
    The attachment resource is used to view, create, and update attachments of a sales lead. An attachment includes additional information about a sales lead.
  • Title: Registration Approval Date
    The date on which a partner registered lead is approved by internal channel manager.
  • Title: Registration Approval Date
    The date and time when the sales lead is approved. This is only applicable to deal registrations.
  • Lead Qualifications
    Title: Lead Qualifications
    The assessments resource is used to view, create and update qualifications of a lead.
  • Title: Asset ID
    The unique identifier of the asset associated with the sales lead.
  • Title: Asset Number
    Maximum Length: 100
    The alternate key identifier of the asset associated with the sales lead.
  • Title: Asset Serial Number
    Read Only: true
    Maximum Length: 100
    The asset serial number associated with the sales lead.
  • Title: Assignment Status
    Maximum Length: 30
    The code indicating the current assignment related status for the lead, for example whether the lead is assigned or unassigned.
  • Title: Budget Amount
    The budget amount associated with this sales lead.
  • Title: Budget Currency
    Maximum Length: 80
    The currency code associated with the Budget Amount. This attribute is used by CRM Extensibility framework. A list of accepted values is defined in the lookup ZCA_COMMON_CORPORATE_CURRENCY. Review and update the profile option using the Setup and Maintenance work area, Manage Trading Community Common Lookups task.
  • Title: Budget Status
    Maximum Length: 120
    The budget status associated with the Budget Amount.
  • Title: Building
    Maximum Length: 40
    The specific building name or number at a given address.
  • Title: Business Unit Identifier
    The unique identifier of the Business Unit which is associated with the business unit of the sales lead creator.
  • Title: Campaign
    Read Only: true
    Maximum Length: 250
    The name of the campaign associated with this sales lead.
  • Title: Source
    Maximum Length: 30
    The channel through which a lead contacted the company.
  • Title: Industry Classification Code
    Maximum Length: 30
    The auxiliary dimension for the Account.
  • Title: Auxiliary Classification Code 1
    Maximum Length: 30
    The auxiliary dimension for the Account.
  • Title: Auxiliary Classification Code 2
    Maximum Length: 30
    The auxiliary dimension for the Account.
  • Title: Auxiliary Classification Code 3
    Maximum Length: 30
    The auxiliary dimension for the Account.
  • Title: Conflict Identifier
    Default Value: 1
    The value guarantees the uniqueness of the row when duplicates are created in different databases such as mobile databases, or the server.
  • Title: Don't Contact Preference
    Maximum Length: 30
    Indicates the don't contact preference of the sales lead.
  • Title: Primary Contact Address
    Read Only: true
    The primary address of a lead's primary contact.
  • Title: Primary Contact Number
    Read Only: true
    Maximum Length: 30
    The alternate identifier of the primary contact.
  • Title: Contact Time Zone
    Maximum Length: 35
    The preferred time zone of the contact pursued on the lead.
  • Title: Converted Date
    The date and time when the sales lead is converted to an opportunity.
  • Title: Created By
    Read Only: true
    Maximum Length: 64
    The user who created this lead record.
  • Title: Creation Date
    Read Only: true
    The date and time when this record is created.
  • Title: Currency
    Maximum Length: 15
    The currency code associated with the lead. This attribute is used by CRM Extensibility framework. A list of accepted values is defined in the lookup ZCA_COMMON_CORPORATE_CURRENCY. Review and update the profile option using the Setup and Maintenance work area, Manage Trading Community Common Lookups task.
  • Title: Customer ID
    The unique identifier of the Customer. It is a reference to the customer record in the TCA schema.
  • Title: Customer Need
    Maximum Length: 30
    The need the lead product serves for the lead customer.
  • Title: Account Name
    Maximum Length: 360
    The name of the customer.
  • Title: Deal Size
    The total amount attributed to a lead.
  • Title: Decision Maker Identified
    Maximum Length: 120
    Default Value: false
    Indicates if the decision maker at customer site has been identified.
  • Read Only: true
    Indicates if the user has access to delete the record. The default value is false.
  • Title: Description
    Maximum Length: 2000
    The description of a sales lead.
  • Title: Distance
    Read Only: true
    The distance of the lead address from the current location.
  • Title: Eligible for Conversion
    Maximum Length: 1
    Specifies whether the lead is eligible for conversion to opportunity.
  • Title: Create Account
    Maximum Length: 1
    Indicates whether new account should be created during lead conversion.
  • Title: Create Contact
    Maximum Length: 1
    Indicates whether new contact should be created during lead conversion.
  • Title: Estimated Close Date
    The date when a registered deal is expected to close.
  • Title: Expiration Date
    The date when a sales lead will expire.
  • Title: Contact Address Floor Number
    Maximum Length: 40
    The specific floor number at a given address or in a particular building when building number is provided.
  • Title: Next Follow-up Date
    Indicates when the sales lead needs to be followed up.
  • Title: Contact Phone
    Read Only: true
    The formatted phone number of the primary contact for the lead.
  • Title: Installed Base Asset
    The unique identifier for the IB asset associated with the sales lead.
  • Title: Installed Base Asset Number
    Read Only: true
    Maximum Length: 80
    The unique number for the IB asset associated with the sales lead.
  • Title: Installed Base Asset Serial Number
    Read Only: true
    Maximum Length: 80
    The unique serial number for the IB asset associated with the sales lead.
  • Interviews
    Title: Interviews
    The interviews resource is used to view and delete an interview record.
  • Title: Product Item
    Maximum Length: 240
    The description of the product added to a lead.
  • Title: Job Title
    Maximum Length: 100
    The job title of the sales lead contact.
  • Title: Last Automatic Assignment Date
    The date on which the lead was last reassigned.
  • Title: Last Update Date
    Read Only: true
    The date and time when the lead data was last updated.
  • Title: Last Updated By
    Read Only: true
    Maximum Length: 64
    The user who last updated the lead record.
  • Title: Last Updated Login
    Read Only: true
    Maximum Length: 32
    The session login associated to the user who last updated the sales lead record.
  • Title: Latitude
    The latitude information for the lead address. The latitude information for the location is used for spatial proximity and containment purposes.
  • Title: Accepted
    Maximum Length: 4
    Indicates if the lead has been accepted.
  • Title: Age in Days
    Read Only: true
    The number of days elapsed since the lead was created.
  • Lead Campaigns
    Title: Lead Campaigns
    The lead campaign resource is used to view, create, update, and delete the association of a campaign with a lead.
  • Sales Lead Competitors
    Title: Sales Lead Competitors
    The lead competitors resource is used to view, create, update, and delete the association of a campaign with a lead.
  • Title: Lead Created By
    Maximum Length: 64
    The user who created the lead record.
  • Title: Lead Creation Date
    The date when the lead was created.
  • Title: Lead Identifier
    The unique identifier of the sales lead.
  • Title: Lead Last Update Date
    The date when the lead record was last updated.
  • Title: Lead Last Updated By
    Maximum Length: 64
    The user who last updated the lead record.
  • Title: Lead Number
    Maximum Length: 30
    The alternate key identifier of the lead.
  • Opportunities
    Title: Opportunities
    The opportunity resource is used to view, create, or modify an opportunity generated from a lead. An opportunity list associated with the lead represents leads that have already been converted to the list of opportunities.
  • Title: Origin
    Maximum Length: 30
    Default Value: SALES_LEAD
    The origin of the lead.
  • Lead Rollups
    Title: Lead Rollups
    The lead rollups resource is used to view a sales lead rollup.
  • Lead Score Details
    Title: Lead Score Details
    The lead score details resource is used to view the details of lead conversion probability.
  • Links
  • Title: Longitude
    The longitude information for the lead address. The longitude information for the location is used for spatial proximity and containment purposes.
  • Sales Lead Resources
    Title: Sales Lead Resources
    The sales lead resources data object (resource) is used to capture a resource associated with the sales lead team. A lead resource is a business object that is used to represent resources who are team members that form part of the lead sales team.
  • Sales Lead Contacts
    Title: Sales Lead Contacts
    The sales lead contacts resource is used to capture a contact associated with the sales lead.
  • Lead Team
    Title: Lead Team
    The lead teams resource is used to view the team members and territory team members associated with a lead.
  • Sales Lead Territories
    Title: Sales Lead Territories
    The sales lead territories resource is used to view the associated sales lead territories.
  • Sales Lead Products
    Title: Sales Lead Products
    The sales lead products resource is used to capture a product associated with the sales lead.
  • Title: Lead Name
    Maximum Length: 250
    The name of the lead.
  • Notes
    Title: Notes
    The note resource is used to capture comments, information, or instructions for a sales lead.
  • Title: Opportunity Name
    The name of the opportunity created from converting the lead.
  • Title: Opportunity Owner Number
    The alternate identifier for the owner of the opportunity created from converting the lead.
  • Orchestration Associations
    Title: Orchestration Associations
    The orchestrations associations resource is used to view, create, update, and delete an orchestration association.
  • Title: Organization Size
    Maximum Length: 30
    The size of the Organization.
  • Title: Organization Type
    Maximum Length: 30
    The type of the Organization.
  • Title: Owner ID
    The unique party identifier associated with the owner of this sales lead.
  • Title: Owner
    Maximum Length: 360
    The name of the owner of a sales lead.
  • Title: Owner Number
    Read Only: true
    Maximum Length: 30
    The alternate owner number key for referenced owner.
  • Title: Partner Number
    Maximum Length: 30
    The alternate partner number key for the referenced partner company.
  • Title: Primary Partner Identifier
    The unique identifier of the primary partner associated with the lead.
  • Title: Primary Partner
    The name of the partner associated with the sales lead.
  • Title: Partner Program
    The unique identifier for the partner program in which the primary partner associated with this sales lead is enrolled. This is a deal specific attribute.
  • Title: Partner Program Number
    Maximum Length: 30
    The partner program number alternate key for the referenced partner program.
  • Title: Partner Type
    Maximum Length: 30
    The type of the primary partner associated with this sales lead. This is a deal specific attribute.
  • Title: Postal Code
    Maximum Length: 10
    The four digit extension to the United States Postal ZIP code.
  • Title: Primary Campaign ID
    The unique identifier of the primary campaign of the Lead. It is a reference key to campaign object.
  • Title: Primary Campaign
    The name of the primary campaign of the lead.
  • Title: Primary Campaign Number
    Maximum Length: 30
    The alternate identifier for primary campaign of the lead.
  • Title: Primary Competitor
    The name of the primary competitor of the lead.
  • Title: Primary Competitor Party ID
    The unique identifier of the primary competitor of the lead. It is a reference key to competitor object.
  • Title: Primary Competitor Party Number
    Read Only: true
    Maximum Length: 30
    The alternate identifier for primary competitor of the lead.
  • Title: Primary Contact Address 1
    Maximum Length: 240
    The first line of address associated with the primary contact of the lead.
  • Title: Primary Contact Address 2
    Maximum Length: 240
    The second line of address associated with the primary contact of the lead.
  • Title: Primary Contact Address 3
    Maximum Length: 240
    The third line of address associated with the primary contact of the lead.
  • Title: Primary Contact Address 4
    Maximum Length: 240
    The fourth line of address associated with the primary contact of the lead.
  • Title: Primary Contact City
    Maximum Length: 60
    The city where the primary contact of the lead is located.
  • Title: Country
    Maximum Length: 2
    The country where the primary contact of the lead is located.
  • Title: Country Name
    Read Only: true
    The name of the country associated with the primary contact.
  • Title: Primary Contact County
    Maximum Length: 60
    The county where the primary contact of the lead is located.
  • Title: Contact Email
    Maximum Length: 320
    The Email address for the primary sales lead contact on the lead.
  • Title: Email Preference
    Maximum Length: 30
    Indicates if the user can e-mail the lead or not. If the value is True, then the user must not contact the person by e-mail. The default value is False. A list of accepted values is defined using the lookup YES_NO. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Common Lookups task.
  • Title: Email Verification Date
    The verification date for primary contact email address.
  • Title: Email Verification Status
    Maximum Length: 30
    The verification status for primary contact email address.
  • Title: Primary Contact ID
    The unique identifier of the sales lead contact marked as a primary lead contact.
  • Title: Mail Preference
    Maximum Length: 30
    Indicates if the user can send mail to the lead or not. If the value is True, then the user must not contact the person by mail. The default value is False. A list of accepted values is defined using the lookup YES_NO. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Common Lookups task.
  • Title: Primary Contact Name
    Maximum Length: 450
    The name associated with the primary lead contact.
  • Title: Primary Contact First Name
    Maximum Length: 150
    The first name of the primary contact for a lead.
  • Title: Primary Contact Last Name
    Maximum Length: 150
    The last name of the primary contact for a lead.
  • Title: Primary Contact Middle Name
    Maximum Length: 150
    The middle name of the primary contact for a lead.
  • Title: Phone Preference
    Maximum Length: 30
    Indicates if the user can contact the lead or not by phone, e-mail, or mail. If the value is True, then the user must not contact the person. The default value is False. A list of accepted values is defined using the lookup YES_NO. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Common Lookups task.
  • Title: Primary Contact Postal Code
    Maximum Length: 60
    The zip code where the primary contact of the lead is located.
  • Title: Primary Contact Province
    Maximum Length: 60
    The province where the primary contact of the lead is located.
  • Title: Primary Contact Relationship ID
    The unique identifier of the relationship primary contact has with its parent organization.
  • Title: Primary Contact State
    Maximum Length: 60
    The state where the primary contact of the lead is located.
  • Title: Primary Product ID
    The unique identifier of the primary product associated with a lead.
  • Title: Primary Inventory Item Number
    Read Only: true
    Maximum Length: 300
    The alternate key for referenced the primary inventory item.
  • Title: Primary Product Organization ID
    The unique identifier of the organization to which the primary product associated with a lead belongs.
  • Title: Primary Phone Area Code
    Maximum Length: 10
    The primary phone area code for the sales lead contact.
  • Title: Primary Phone Country Code
    Maximum Length: 10
    The primary phone country code for the sales lead contact.
  • Title: Contact Phone
    Maximum Length: 40
    The primary phone number for the sales lead contact.
  • Title: Primary Phone Verification Date
    The verification date for lead primary phone.
  • Title: Primary Phone Verification Status
    Maximum Length: 30
    The verification status for lead primary phone.
  • Title: Primary Product Group ID
    The unique identifier of the primary product group associated with a lead.
  • Title: Primary Product Group Reference Number
    Maximum Length: 50
    The alternate key for the referenced primary product group.
  • Title: Product Group Description
    Read Only: true
    Maximum Length: 1000
    The description of the product group.
  • Title: Product Group
    Maximum Length: 250
    The name of the product group if this record represents a product group.
  • Product Groups
    Title: Product Groups
    The product groups resource is used to capture the name of the product group associated with the sales lead. A product group is a business object that groups related products, so that you can work with them together. You can use product groups to create a multilevel hierarchy that can be used as a sales catalog, a rollup hierarchy, or a promotion catalog. For example, you might create a product group named Consumer Electronics that includes all of your consumer electronics products so that customers can browse through all the products in this group in your product catalog.
  • Products
    Title: Products
    The product resource is used to capture the name of the product associated with the sales lead.
  • Title: Product Type
    The type of the primary product, such as item or product group.
  • Title: Partner Program
    The name of the partner program in which the primary partner associated with this sales lead is enrolled. This is a deal specific attribute.
  • Title: Customer Project
    Maximum Length: 30
    The customer project identified for this sales lead.
  • Title: Qualification Score
    Read Only: true
    Default Value: 0
    The qualification score for a lead.
  • Title: Qualification Date
    The date when this sales lead was qualified.
  • Title: Qualification Date
    The date and time when the sales lead is qualified.
  • Title: Rank
    Maximum Length: 30
    The rank associated with this sales lead.
  • Title: Raw Phone Number
    The raw value of the lead primary phone number.
  • Title: Reassign Comments
    Maximum Length: 1000
    The comment provided by a user while requesting the lead reassignment.
  • Title: Reassign Reason
    Maximum Length: 30
    The code indicating the reason for reassigning the lead. A list of valid values is defined in the lookup ReassignVA.
  • Title: Record Set
    Read Only: true
    The record visibility filters for lead search based on the resource and the leads to which the resource is associated to. The set is a group of lead records considered as the base group before other search criteria is used to further refine the search results.
  • Title: Registration Number
    Maximum Length: 120
    The registration number of the sales lead. This unique identifier is generated when the sales lead is approved. This is a deal specific attribute.
  • Title: Registration Status
    Maximum Length: 120
    The approval Status of the sales lead. This is a deal specific attribute.
  • Title: Registration Type
    Maximum Length: 120
    The registration type of the sales lead. This is a deal specific attribute.
  • Title: Reject by User ID
    The unique identifier of the sales representative who rejected this sales lead.
  • Title: Rejection Comments
    Maximum Length: 250
    The comments provided by the sales representative who rejected this sales lead.
  • Title: Rejected Time Stamp
    The date and time when the sales lead is rejected.
  • Title: Reject Reason
    Maximum Length: 30
    The code indicating the reason for rejecting the lead. A list of valid values is defined in the lookup RejectReasonVA.
  • Title: Retirement Comments
    Maximum Length: 250
    The comments recorded when the sales lead is moved to a retired status.
  • Title: Retired Time Stamp
    The date and time when the sales lead is moved to a retired status.
  • Title: Retire Reason
    Maximum Length: 30
    The code indicating the reason for retiring the lead. A list of valid values is defined in the lookup RetireReasonVA.
  • Title: Sales Channel
    Maximum Length: 120
    The sales channel responsible for following up on this sales lead.
  • Sales Contents
    Title: Sales Contents
    The sales contents resource is used to view, create, update, and delete the sales content associated with a lead.
  • Title: Last Sync to Marketing Date
    The date on which the current sales target lead contacts are last synced to Eloqua.
  • Title: Opt-out Comment
    Maximum Length: 1000
    The comments provided by the sales representative who opted out this lead.
  • Title: Opt-out Date
    The date of opting out the lead from sales target campaign.
  • Title: Opt-out Reason
    Maximum Length: 32
    The reason for opting out the lead from sales target campaign.
  • Title: Stage
    Maximum Length: 32
    The lead's current stage in the account based selling process.
  • Title: Validation Due Date
    The date on which the sales target lead validation is due.
  • Title: Score
    The score associated with this sales lead. This score is computed based on the scoring rules.
  • Smart Actions
    Title: Smart Actions
    The smart actions resource is used to view the name, security, context object, REST operation, confirmation message, and other global properties of smart actions. Smart action item or collection links returned in response payloads are valid at the moment the REST request is processed. Any change to the parent object context can invalidate a previously valid smart action.
  • Title: Source Code
    Maximum Length: 30
    The marketing source code associated with this sales lead.
  • Marketing Source Codes
    Title: Marketing Source Codes
    The marketing source code resource is used to track responses and leads generated by each sales and marketing campaigns, and helps gauge the effectiveness of each initiative. A marketing source code is a unique identifier representing a marketing campaign and the underlying treatment and segment or list used within each execution.
  • Title: Status
    Maximum Length: 30
    Default Value: UNQUALIFIED
    The code indicates the current status of the lead. A list of valid values is defined in the lookup StatusCodeVA.
  • Title: Time Frame
    Maximum Length: 120
    The timeframe associated with this sales lead.
  • Title: Reassign
    Maximum Length: 1
    Default Value: false
    Indicates leads that are either unassigned or have been selected for automatic reassignment.
  • Read Only: true
    Indicates if the user has access to update the record. The default value is false.
  • Title: Work Phone Area Code
    Maximum Length: 10
    The area code of the work phone associated with the sales lead contact.
  • Title: Work Phone Country Code
    Maximum Length: 10
    The country code of the work phone associated with the sales lead contact.
  • Title: Work Phone Number
    Maximum Length: 40
    The work phone number of the sales lead contact.
Nested Schema : Sales Leads Attachments
Type: array
Title: Sales Leads Attachments
The attachment resource is used to view, create, and update attachments of a sales lead. An attachment includes additional information about a sales lead.
Show Source
Nested Schema : Lead Qualifications
Type: array
Title: Lead Qualifications
The assessments resource is used to view, create and update qualifications of a lead.
Show Source
Nested Schema : Interviews
Type: array
Title: Interviews
The interviews resource is used to view and delete an interview record.
Show Source
Nested Schema : Lead Campaigns
Type: array
Title: Lead Campaigns
The lead campaign resource is used to view, create, update, and delete the association of a campaign with a lead.
Show Source
Nested Schema : Sales Lead Competitors
Type: array
Title: Sales Lead Competitors
The lead competitors resource is used to view, create, update, and delete the association of a campaign with a lead.
Show Source
Nested Schema : Opportunities
Type: array
Title: Opportunities
The opportunity resource is used to view, create, or modify an opportunity generated from a lead. An opportunity list associated with the lead represents leads that have already been converted to the list of opportunities.
Show Source
Nested Schema : Lead Rollups
Type: array
Title: Lead Rollups
The lead rollups resource is used to view a sales lead rollup.
Show Source
Nested Schema : Lead Score Details
Type: array
Title: Lead Score Details
The lead score details resource is used to view the details of lead conversion probability.
Show Source
Nested Schema : Sales Lead Resources
Type: array
Title: Sales Lead Resources
The sales lead resources data object (resource) is used to capture a resource associated with the sales lead team. A lead resource is a business object that is used to represent resources who are team members that form part of the lead sales team.
Show Source
Nested Schema : Sales Lead Contacts
Type: array
Title: Sales Lead Contacts
The sales lead contacts resource is used to capture a contact associated with the sales lead.
Show Source
Nested Schema : Lead Team
Type: array
Title: Lead Team
The lead teams resource is used to view the team members and territory team members associated with a lead.
Show Source
Nested Schema : Sales Lead Territories
Type: array
Title: Sales Lead Territories
The sales lead territories resource is used to view the associated sales lead territories.
Show Source
Nested Schema : Sales Lead Products
Type: array
Title: Sales Lead Products
The sales lead products resource is used to capture a product associated with the sales lead.
Show Source
Nested Schema : Notes
Type: array
Title: Notes
The note resource is used to capture comments, information, or instructions for a sales lead.
Show Source
Nested Schema : Orchestration Associations
Type: array
Title: Orchestration Associations
The orchestrations associations resource is used to view, create, update, and delete an orchestration association.
Show Source
Nested Schema : Product Groups
Type: array
Title: Product Groups
The product groups resource is used to capture the name of the product group associated with the sales lead. A product group is a business object that groups related products, so that you can work with them together. You can use product groups to create a multilevel hierarchy that can be used as a sales catalog, a rollup hierarchy, or a promotion catalog. For example, you might create a product group named Consumer Electronics that includes all of your consumer electronics products so that customers can browse through all the products in this group in your product catalog.
Show Source
Nested Schema : Products
Type: array
Title: Products
The product resource is used to capture the name of the product associated with the sales lead.
Show Source
Nested Schema : Sales Contents
Type: array
Title: Sales Contents
The sales contents resource is used to view, create, update, and delete the sales content associated with a lead.
Show Source
Nested Schema : Smart Actions
Type: array
Title: Smart Actions
The smart actions resource is used to view the name, security, context object, REST operation, confirmation message, and other global properties of smart actions. Smart action item or collection links returned in response payloads are valid at the moment the REST request is processed. Any change to the parent object context can invalidate a previously valid smart action.
Show Source
Nested Schema : Marketing Source Codes
Type: array
Title: Marketing Source Codes
The marketing source code resource is used to track responses and leads generated by each sales and marketing campaigns, and helps gauge the effectiveness of each initiative. A marketing source code is a unique identifier representing a marketing campaign and the underlying treatment and segment or list used within each execution.
Show Source
Nested Schema : leads-AllLeadAttachments-item-response
Type: object
Show Source
Nested Schema : leads-Assessments-item-response
Type: object
Show Source
Nested Schema : Assessment Answer Groups
Type: array
Title: Assessment Answer Groups
The assessment answer groups resource is used to view question groups in an assessment.
Show Source
Nested Schema : leads-Assessments-AssessAnswerGroups-item-response
Type: object
Show Source
Nested Schema : Assessment Answers
Type: array
Title: Assessment Answers
The assessment answer resource is used to view and update a response for a question in a question group.
Show Source
Nested Schema : leads-Assessments-AssessAnswerGroups-AssessmentAnswer-item-response
Type: object
Show Source
Nested Schema : leads-Interviews-item-response
Type: object
Show Source
Nested Schema : leads-LeadCampaigns-item-response
Type: object
Show Source
Nested Schema : leads-LeadCompetitors-item-response
Type: object
Show Source
Nested Schema : leads-LeadOpportunity-item-response
Type: object
Show Source
  • Title: Customer Name
    Read Only: true
    The account associated with the lead.
  • Title: Currency
    Read Only: true
    The currency associated with the opportunity revenue amount.
  • Title: Expected Revenue
    Read Only: true
    The win probability percentage of the revenue amount.
  • Title: Lead Name
    Read Only: true
    The lead name used for identifying the lead.
  • Title: Lead Number
    Read Only: true
    The lead number of the lead from which the opportunity originated.
  • Links
  • Title: Close Date
    Read Only: true
    The date when the opportunity closes.
  • Title: Opportunity ID
    Read Only: true
    The unique identifier of the opportunity associated with the lead.
  • Title: Opportunity
    Read Only: true
    The name of the opportunity associated with the lead.
  • Title: Opportunity Number
    Read Only: true
    The alternate key identifier of the opportunity associated with the lead.
  • Title: Status
    Read Only: true
    The status of the opportunity associated with the lead.
  • Title: Line Revenue
    Read Only: true
    The revenue amount of the opportunity associated with the lead.
  • Title: Sales Stage ID
    Read Only: true
    The unique identifier of the sales stage of the opportunity associated with the lead.
  • Title: Name
    Read Only: true
    The name of the sales stage of the opportunity associated with the lead.
  • Title: Win Probability
    Read Only: true
    The win probability of the opportunity associated with the lead.
Nested Schema : leads-LeadRollup-item-response
Type: object
Show Source
Nested Schema : leads-leadScoreDetails-item-response
Type: object
Show Source
  • Read Only: true
    Maximum Length: 255
    The data type associated with the value of the feature used for predictions from the AI models.
  • Read Only: true
    The name of the feature used for predictions from the AI models.
  • Read Only: true
    Maximum Length: 255
    The value of the feature used for predictions from the AI models.
  • Links
Nested Schema : leads-MklLeadResources-item-response
Type: object
Show Source
  • Title: Access
    Maximum Length: 30
    Default Value: FULL
    The code indicating the access level of a team member.
  • Title: Conflict Identifier
    Default Value: 1
    The value guarantees the uniqueness of the row when duplicates are created in different databases such as mobile databases, or the server.
  • Title: Created By
    Read Only: true
    Maximum Length: 64
    The user who created this sales lead resource.
  • Title: Creation Date
    Read Only: true
    The date and time when this sales lead resource is created.
  • Title: Email
    Read Only: true
    Maximum Length: 320
    The e-mail address associated with the sales lead team resource.
  • Title: Phone
    Read Only: true
    The formatted phone number of the lead sales team resource.
  • Title: Function
    Maximum Length: 30
    The role played by this Sale team resource for the handling of this sales lead.
  • Title: Last Updated Date
    Read Only: true
    The date and time of the last update of the sales lead resource.
  • Title: Last Updated By
    Read Only: true
    Maximum Length: 64
    The user who last updated the sales lead resource.
  • Title: Last Updated Login
    Read Only: true
    Maximum Length: 32
    The login of the user who last updated the record.
  • Title: Lead ID
    The unique identifier of the sales lead for this sales lead resource.
  • Title: Lead Number
    Maximum Length: 30
    The alternate unique identifier of the lead.
  • Title: Lead Resource ID
    The unique identifier of the sales lead resource.
  • Links
  • Title: Manager Name
    Read Only: true
    Maximum Length: 360
    The name of the sales lead manager.
  • Title: Organization
    Read Only: true
    Maximum Length: 240
    The name of the sales lead resource.
  • Title: Team Member
    Read Only: true
    Maximum Length: 360
    The name of the party associated with the sales lead resource.
  • Title: Resource Party Number
    Read Only: true
    Maximum Length: 30
    The contact number of the party associated with the lead resource.
  • Title: Primary
    Maximum Length: 1
    Default Value: false
    Indicates whether the record represents the primary resource on the lead. The primary resource on the lead is the same as the lead owner.
  • Title: Role
    Read Only: true
    Maximum Length: 30
    The type of contact point used for updating underlying contact point TCA data.
  • Title: Resource ID
    The unique identifier associated with this sales lead resource.
  • Title: Resource Organization ID
    Read Only: true
    The unique identifier of the resource organization associated with this sales lead resource.
  • Title: Role
    Read Only: true
    Maximum Length: 60
    The name of the role of the sales lead resource associated with the sales lead.
Nested Schema : leads-MklLeadTcMembers1-item-response
Type: object
Show Source
  • Title: Existing Account
    Read Only: true
    Maximum Length: 900
    The account name associated with lead contacts.
  • Title: City
    Read Only: true
    Maximum Length: 60
    City associated with the identifying address associated with this lead contact.
  • Title: Conflict Identifier
    Default Value: 0
    The value guarantees the uniqueness of the row when duplicates are created in different databases such as mobile databases, or the server.
  • Title: Do Not Call
    Read Only: true
    Maximum Length: 1
    Indicates if the user can call the person. If the value is True, then the user can not call the person. The default value is False. A list of accepted values is defined using the lookup YES_NO. You can review and update the value for this attribute using the Setup and Maintenance work area, Manage Common Lookups task.
  • Title: Do Not Contact
    Read Only: true
    Maximum Length: 1
    Indicates if the user can contact the person by phone, e-mail, or mail. If the value is True, then the user can not contact the person. The default value is False.
  • Title: Do Not Mail
    Read Only: true
    Maximum Length: 1
    Indicates whether the sales lead person can be contacted.
  • Title: Job Title
    The label displaying the job title of a contact in his company.
  • Title: Created By
    Read Only: true
    Maximum Length: 64
    The user who created this sales lead contact.
  • Title: Creation Date
    Read Only: true
    The date and time when this sales lead contact is created.
  • Title: Email
    The e-mail address associated with the sales lead contact.
  • Title: Email Preference
    Read Only: true
    Maximum Length: 255
    Indicates if the lead contact has an email preference of do not email, ok to email, or no value.
  • Title: Phone
    The formatted phone number of the lead contact.
  • Title: Title
    Read Only: true
    Maximum Length: 100
    The job title of the sales lead contact.
  • Title: Last Updated Date
    Read Only: true
    The date and time of the last update of the sales lead contact.
  • Title: Last Updated By
    Read Only: true
    Maximum Length: 64
    The user who last updated the sales lead contact.
  • Title: Last Updated Login
    Read Only: true
    Maximum Length: 32
    The session login associated to the user who last updated the sales lead record.
  • Title: Lead ID
    The unique identifier of the sales lead for this sales lead contact.
  • Title: Lead Contact ID
    The unique identifier for the sales lead contact.
  • Title: Lead Number
    Maximum Length: 30
    The alternate unique identifier of the lead.
  • Links
  • Title: Organization Contact ID
    Read Only: true
    The unique identifier of the Organization for this sales lead contact.
  • Title: Contact Party ID
    The unique identifier of the lead to which the contact is associated.
  • Title: Name
    Read Only: true
    Maximum Length: 360
    The name of the party associated with the lead contact.
  • Title: Contact Party Number
    Read Only: true
    Maximum Length: 30
    The party number of the sales lead contact.
  • Title: Type
    Read Only: true
    Maximum Length: 30
    The type of the party recorded as lead contact. Possible values are person, organization or group.
  • Title: Party Usage Code
    Maximum Length: 30
    The party usage recorded for this lead contact in the customer master.
  • Title: First Name
    Read Only: true
    Maximum Length: 150
    The first name of the lead contact.
  • Title: Last Name
    Read Only: true
    Maximum Length: 150
    The last name or surname of a lead contact.
  • Title: Title
    Read Only: true
    Maximum Length: 60
    The title associated with the lead contact. This is not the same as the job title.
  • Title: Phone Preference
    Read Only: true
    Maximum Length: 255
    Indicates whether the lead contact has a phone preference of do not call, ok to call, or no value.
  • Title: Postal Code
    Read Only: true
    Maximum Length: 60
    Postal code part of the identifying address associated with this lead contact.
  • Read Only: true
    The account party identifier of the account associated to the lead contact.
  • Title: Primary
    Maximum Length: 1
    Indicates whether a lead contact is the primary contact. The primary lead contact is also the lead owner.
  • Title: Relationship ID
    The unique relationship identifier for this lead contact. This represents the relation of this lead contact with lead customer.
  • Title: Function
    Maximum Length: 30
    The role of lead contact in the context of this lead.
  • Title: State
    Read Only: true
    Maximum Length: 60
    State part of the identifying address associated with this lead contact.
Nested Schema : leads-MklLeadTeam-item-response
Type: object
Show Source
Nested Schema : leads-MklLeadTerritoryAssoc-item-response
Type: object
Show Source
Nested Schema : leads-MklProdAssoc1-item-response
Type: object
Show Source
  • Title: Amount
    The amount associated with the sales lead product.
  • Title: Average Time to Close
    The average time to close for this sales lead product.
  • Title: Conflict Identifier
    Default Value: 0
    The value guarantees the uniqueness of the row when duplicates are created in different databases such as mobile databases, or the server.
  • Title: Created By
    Read Only: true
    Maximum Length: 64
    The user who created this sales lead product.
  • Title: Creation Date
    Read Only: true
    The date and time when this sales lead product is created.
  • Title: Currency
    Maximum Length: 15
    The currency code associated with the lead product line amount. A list of accepted values is defined in the lookup ZCA_COMMON_CORPORATE_CURRENCY. You can review and update the value for this attribute using the Setup and Maintenance work area, Manage Trading Community Common Lookups task.
  • Title: Item Description
    Maximum Length: 240
    The product description where the product is associated with the lead.
  • Title: Estimated Unit Price
    The estimated unit price for this lead product.
  • Title: Inventory Number
    The unique inventory item identifier associated with the lead product.
  • Title: Inventory Item Number
    Read Only: true
    Maximum Length: 300
    The alternate key for referenced inventory item.
  • Title: Last Updated Date
    Read Only: true
    The date and time of the last update of the sales lead product.
  • Title: Last Updated By
    Read Only: true
    Maximum Length: 64
    The user who last updated the sales lead product.
  • Title: Last Updated Login
    Read Only: true
    Maximum Length: 32
    The login of the user who last updated the record.
  • Title: Lead ID
    The unique identifier of the sales lead for this sales lead product.
  • Title: Lead Number
    Maximum Length: 30
    The alternate unique identifier of the lead.
  • Title: Lead Product ID
    The unique identifier of the current sales lead product.
  • Title: Lead Product Number
    Maximum Length: 30
    The alternate key of the lead product.
  • Links
  • Title: Long Description
    Read Only: true
    Maximum Length: 4000
    A detailed description of the sales lead product.
  • Title: Organization
    The unique inventory organization identifier associated with this lead product.
  • Title: Primary
    Maximum Length: 1
    Indicates whether this product is a primary product for this lead.
  • Title: Product Group Description
    Read Only: true
    Maximum Length: 1000
    A brief description of the product group.
  • Title: Product Group ID
    The unique identifier of the product group.
  • Title: Product Group Name
    Maximum Length: 250
    The name of the product group associated with the sales lead product resource.
  • Title: Product Group Reference Number
    Maximum Length: 50
    The alternate key for referenced product group.
  • Title: Product Type
    The type of the product, such as item or product group.
  • Title: Quantity
    The product quantity identified for this product on the lead.
  • Title: UOM
    Maximum Length: 3
    The unit of measure associated with this sales lead product line.
Nested Schema : leads-Note-item-response
Type: object
Show Source
  • Title: Contact Relationship ID
    The unique identifier of the relationship populated when the note is associated with a sales lead contact.
  • Title: Corporate Currency Code
    Maximum Length: 15
    The corporate currency code of the note associated with the sales lead. A list of accepted values is defined in the lookup ZCA_COMMON_CORPORATE_CURRENCY. Review and update the profile option using the Setup and Maintenance work area, Manage Trading Community Common Lookups task.
  • Title: Created By
    Read Only: true
    Maximum Length: 64
    The user who created the note record.
  • Title: Creation Date
    Read Only: true
    The date and time when the note record was created.
  • Title: Creator Party ID
    The unique party identifier of the note creator.
  • Title: Currency Conversion Rate Type
    Maximum Length: 30
    The currency conversion rate type associated with the note. A list of accepted values is defined in the lookup ZCA_COMMON_RATE_TYPE. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Trading Community Common Lookups task.
  • Title: Currency
    Maximum Length: 15
    The currency code associated with the note. A list of accepted values is defined in the lookup ZCA_COMMON_CORPORATE_CURRENCY. Review and update the value for this attribute using the Setup and Maintenance work area, Manage Trading Community Common Lookups task.
  • Title: Delete Indicator
    Read Only: true
    Indicates whether the note is to be deleted. If the value is Y, then the note has to be deleted. The default value is N.
  • Title: Primary Email
    Read Only: true
    Maximum Length: 320
    The email address of the user who created the note.
  • Title: Primary Address
    Read Only: true
    The address of the user who created the note.
  • Title: Primary Phone
    Read Only: true
    The phone number of the user who created the note.
  • Title: Last Update Date
    Read Only: true
    The date and time when the note data was last updated.
  • Title: Last Updated By
    Read Only: true
    Maximum Length: 64
    The user who last updated the record.
  • Title: Last Update Login
    Read Only: true
    Maximum Length: 32
    The login of the user who last updated the record.
  • Links
  • Title: Note ID
    Read Only: true
    The unique identifier of the note associated with the lead. This is the primary key of the notes table.
  • Maximum Length: 30
    The system generated user key. It can come from external system also.
  • Title: Title
    Maximum Length: 500
    The user provided title for the note.
  • Title: Note
    The column which stores the actual note text.
  • Title: Type
    Maximum Length: 30
    The code indicating the type of the note. A list of valid values defined in the lookup NoteSourceTypeVA.
  • Title: Parent Note ID
    The identifier for the parent note.
  • Title: Party ID
    Read Only: true
    The unique identifier of the lead associated with the note. Either the PartyId, PartyNumber, or PartySourceSystem and PartySourceSystemReferenceValue keys is required to uniquely identify the lead record with which the lead is associated.
  • Title: Author
    Read Only: true
    Maximum Length: 360
    The name of a lead party.
  • Title: Related Object Type
    Maximum Length: 30
    The code indicating the type of the source object such as Activities, Opportunities, as defined in OBJECTS Metadata.
  • Title: Related Object
    Maximum Length: 64
    The primary key identifier of the source object such as Activities, Opportunities, as defined in OBJECTS Metadata.
  • Title: Update Indicator
    Read Only: true
    Indicates whether the note can be updated. If the value is Y, then the note can be updated. The default value is N.
  • Title: Private
    Maximum Length: 30
    Default Value: INTERNAL
    The code indicating the visibility level of the note, such as internal or external.
Nested Schema : leads-OrchestrationAssociations-item-response
Type: object
Show Source
Nested Schema : Error Logs
Type: array
Title: Error Logs
The error logs resource is used to view error logs associated to the orchestration associations.
Show Source
Nested Schema : Stage Objectives
Type: array
Title: Stage Objectives
The stage objectives resource is used to view the stage objectives of the orchestration association.
Show Source
Nested Schema : Stages
Type: array
Title: Stages
The stages resource is used to view the stage of the orchestration association.
Show Source
Nested Schema : Steps
Type: array
Title: Steps
The steps resource is used to view the steps of the orchestration association.
Show Source
Nested Schema : Steps In Execution Path
Type: array
Title: Steps In Execution Path
The steps in execution path resource is used to view all the steps including future steps of the orchestration association.
Show Source
Nested Schema : Step Transitions
Type: array
Title: Step Transitions
The step transitions resource is used to view the step transitions of the orchestration association.
Show Source
Nested Schema : leads-OrchestrationAssociations-ErrorLogs-item-response
Type: object
Show Source
Nested Schema : leads-OrchestrationAssociations-StageObjectives-item-response
Type: object
Show Source
Nested Schema : leads-OrchestrationAssociations-Stages-item-response
Type: object
Show Source
Nested Schema : leads-OrchestrationAssociations-Steps-item-response
Type: object
Show Source
Nested Schema : leads-OrchestrationAssociations-StepsInExecutionPath-item-response
Type: object
Show Source
Nested Schema : leads-OrchestrationAssociations-StepTransitions-item-response
Type: object
Show Source
Nested Schema : leads-productGroups-item-response
Type: object
Show Source
Nested Schema : leads-products-item-response
Type: object
Show Source
Nested Schema : leads-SalesContents-item-response
Type: object
Show Source
Nested Schema : leads-smartActions-item-response
Type: object
Show Source
  • Title: Action Intent
    JSON object that describes what an action does and what context data can be passed to the action.
  • Title: Confirmation Message
    Maximum Length: 4000
    The confirmation message displayed before the smart action runs. An affirmative response allows the smart action to run.
  • Title: Content Type
    Maximum Length: 50
    The media type of the smart action REST operation.
  • Title: Action Name
    Maximum Length: 256
    The display name of the smart action.
  • Title: Parent Entity
    Maximum Length: 150
    The primary object the smart action is associated with. For example, if the smart action creates an appointment for a lead, lead is the primary object.
  • Title: REST Endpoint
    Maximum Length: 150
    The relative path of the smart action REST resource. The path can include path parameters.
  • Title: Included in Application
    Maximum Length: 512
    The client applications that the smart action is associated with.
  • Links
  • Title: Mass Action
    Maximum Length: 1
    Indicates whether the action can be mass processed.
  • Title: HTTP Method
    Maximum Length: 15
    The HTTP method of the smart action REST operation.
  • Title: Object Function
    Maximum Length: 64
    The object function associated with the smart action.
  • Title: Page Type
    Maximum Length: 256
    The list of pages that this action can be used in.
  • Title: Smart Suggest
    Maximum Length: 1
    Indicates whether the smart suggest is enabled for the action.
  • Title: System Action
    Maximum Length: 1
    The system assigned value indicating whether the smart action is seeded or custom. 'True' indicates the smart action is seeded.
  • Title: Attributes to Update
    Maximum Length: 512
    The object attribute to be updated as a result of using a data entry form. It is used by the applications to determine which form to use. The value is object scoped and must be unique across all smart actions for an object.
  • Title: User Action ID
    The unique system assigned identifier of the smart action definition.
  • Title: Action Name
    Maximum Length: 256
    The unique system assigned smart action name.
  • Smart Action User Interface Definitions
    Title: Smart Action User Interface Definitions
    The user interface definitions resource is used to view the user interfaces associated with a smart action. Each user interface can be mapped to a client application. Smart action item or collection links returned in response payloads are valid at the moment the REST request is processed. Any change to the parent object context can invalidate a previously valid smart action.
  • Title: Priority
    The number defining the relative position of the smart action in the list of smart actions displayed in a client application.
  • Smart Action REST Payload Definitions
    Title: Smart Action REST Payload Definitions
    The payload definitions resource is used to view the REST request payload name-value pair definitions of a smart action. Smart action item or collection links returned in response payloads are valid at the moment the REST request is processed. Any change to the parent object context can invalidate a previously valid smart action.
  • Smart Action REST Path Parameter Definitions
    Title: Smart Action REST Path Parameter Definitions
    The path parameter definitions resource is used to view the REST request path parameter name-value pair definitions of a smart action. Smart action item or collection links returned in response payloads are valid at the moment the REST request is processed. Any change to the parent object context can invalidate a previously valid smart action.
Nested Schema : Smart Action User Interface Definitions
Type: array
Title: Smart Action User Interface Definitions
The user interface definitions resource is used to view the user interfaces associated with a smart action. Each user interface can be mapped to a client application. Smart action item or collection links returned in response payloads are valid at the moment the REST request is processed. Any change to the parent object context can invalidate a previously valid smart action.
Show Source
Nested Schema : Smart Action REST Payload Definitions
Type: array
Title: Smart Action REST Payload Definitions
The payload definitions resource is used to view the REST request payload name-value pair definitions of a smart action. Smart action item or collection links returned in response payloads are valid at the moment the REST request is processed. Any change to the parent object context can invalidate a previously valid smart action.
Show Source
Nested Schema : Smart Action REST Path Parameter Definitions
Type: array
Title: Smart Action REST Path Parameter Definitions
The path parameter definitions resource is used to view the REST request path parameter name-value pair definitions of a smart action. Smart action item or collection links returned in response payloads are valid at the moment the REST request is processed. Any change to the parent object context can invalidate a previously valid smart action.
Show Source
Nested Schema : leads-smartActions-UserActionNavigation-item-response
Type: object
Show Source
  • Links
  • Title: System Action
    Maximum Length: 1
    Default Value: false
    The system assigned value indicating whether the smart action is seeded or custom. 'True' indicates the smart action is seeded. The value is automatically derived from smartActions.SystemActionFlag.
  • Title: Application Usage
    Maximum Length: 50
    The client application associated with a smart action user interface endpoint definition identified by UserActionNavId.
  • Title: Navigation Metadata
    Maximum Length: 1000
    The metadata definition of the smart action user interface endpoint.
  • Title: Primary Key
    The unique system assigned identifier of a smart action user interface definition.
  • Title: Navigation Type
    Maximum Length: 100
    The text value used by applications to determine which user interface to launch.
Nested Schema : leads-smartActions-UserActionRequestPayload-item-response
Type: object
Show Source
  • Title: Payload Value Binding Type
    Maximum Length: 64
    The classification of the value property of a name-value pair. A binding value of RUNTIME indicates the value to be assigned is the runtime value of an object attribute. A value of STATIC indicates the value to be assigned is a simple string. A null value indicates that the value type is JSON_ARRAY_STRING.
  • Links
  • Title: Mandatory
    Maximum Length: 1
    Indicates whether a REST payload body parameter value is mandatory. If True, runtime validation ensures that the value is defined.
  • The unique system assigned identifier of a smart action REST payload body parameter name-value pair definition.
  • Title: Request Payload Attribute Name
    Maximum Length: 256
    The value assigned to the name property of a name-value pair.
  • Title: Smart Suggest Path
    Maximum Length: 2048
    The path used for smart suggest.
  • Title: System Action
    Maximum Length: 1
    Default Value: false
    The system assigned value indicating whether the smart action is seeded or custom. 'True' indicates the smart action is seeded. The value is automatically derived from smartActions.SystemActionFlag.
  • Title: Request Payload Attribute Value
    Maximum Length: 1000
    The value assigned to the value property of a name-value pair.
  • Title: Payload Value Structure
    Maximum Length: 20
    A value of JSON_ARRAY_STRING indicates that the value property of a name-value pair represents an array of data rather than a single entity such as an object attribute name or simple text string. The array string is a definition of the name-value pair and the Binding and Mandatory properties. The array string follows specific pattern, for example [{"name":"leadId","Value":"LeadId","MandatoryFlag":true,"Binding":"RUNTIME"}]. A null value indicates the value property represents a simple, single entity such as an object attribute name or simple text string.
Nested Schema : leads-smartActions-UserActionURLBinding-item-response
Type: object
Show Source
  • Title: URL Binding Type
    Maximum Length: 64
    The classification of the value property of a name-value pair. The binding value of a UserActionURLBinding instance must be RUNTIME. A binding value of RUNTIME indicates the value to be assigned is the runtime value of an object attribute.
  • Links
  • Title: System Action
    Maximum Length: 1
    Default Value: false
    The system assigned value indicating whether the smart action is seeded or custom. 'True' indicates the smart action is seeded. The value is automatically derived from smartActions.SystemActionFlag.
  • The unique system assigned identifier of a smart action REST path parameter name-value pair definition.
  • Title: URL Binding Parameter Name
    Maximum Length: 50
    The value assigned to the name property of a name-value pair.
  • Title: URL Binding Parameter Value
    Maximum Length: 80
    The value assigned to the value property of a name-value pair.
Nested Schema : leads-sourceCodes-item-response
Type: object
Show Source
  • Title: Active
    Maximum Length: 1
    Default Value: true
    Indicates an active or inactive status of this source code.
  • Title: Campaign ID
    The unique identifier of the campaign associated with this source code.
  • Title: Campaign
    Read Only: true
    Maximum Length: 250
    The name of the campaign associated with this source code.
  • Title: Campaign Type
    Read Only: true
    Maximum Length: 30
    Campaign Usage associated with source code.
  • Title: Created By
    Read Only: true
    Maximum Length: 64
    The user who created this source code record.
  • Title: Creation Date
    Read Only: true
    The date and time when this record is created.
  • Title: Last Updated Date
    Read Only: true
    Who column: indicates the date and time of the last update of the row.
  • Title: Last Updated By
    Read Only: true
    Maximum Length: 64
    Who column: indicates the user who last updated the row.
  • Title: Last Updated Login
    Read Only: true
    Maximum Length: 32
    Who column: indicates the session login associated to the user who last updated the row.
  • Links
  • Title: Object Version Number
    Used to implement optimistic locking. This number is incremented every time that the row is updated. The number is compared at the start and end of a transaction to detect whether another session has updated the row since it was queried.
  • Title: Source Code
    Maximum Length: 100
    The source code that represents this record.
  • Title: Source Code ID
    The unique identifier of the source code.
Back to Top

Examples

The following example shows how to update a sales lead by submitting a PATCH request on the REST resource using cURL.

curl -u <username:password> \ -X PATCH -d @example_request_payload.json https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/leads/300100070255847

Example of Request Body

The following example shows the request body to update a sales lead.

{
  "Score": 99,
  "Description": "Updated Lead Description"
}

Example of Response Body

The following example shows the contents of the response body in JSON format.

{
  "Name": "FirstName LastName 2/19/16 2:58 AM",
  "LeadNumber": "CDRM_170310",
  "OwnerPartyName": "Gabrielle   Lee",
  "StatusCode": "UNQUALIFIED",
  "Rank": "HOT",
  "SourceCode": null,
  "CustomerPartyName": "New Account Name",
  "CreationDate": "2016-02-19T10:58:43+00:00",
  "RegistrationNumber": null,
  "RegistrationType": null,
  "RegistrationStatus": null,
  "PrimaryContactPartyName": "FirstName LastName",
  "Timeframe": null,
  "LastUpdateDate": "2016-02-19T10:58:43+00:00",
  "LeadId": 300100070255847,
  "CreatedBy": "SALES_ADMIN",
  "LastUpdatedBy": "SALES_ADMIN",
  "LastUpdateLogin": "2C1D48368055738CE0539544F00AB05B",
  "Score": 99,
  "CustomerId": null,
  "BusinessUnitId": 204,
  "PrimaryContactId": null,
  "Description": "Updated Lead Description",
    ...
    .
    .
    {
      "rel": "lov",
      "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/leads/300100070255847/lov/RegistrationStatusVA",
      "name": "RegistrationStatusVA",
      "kind": "collection"
    },
        },
         ....
    .
    .
    {
      "rel": "child",
      "href": "https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/leads/300100070255847/child/MklLeadTcMembers1",
      "name": "MklLeadTcMembers1",
      "kind": "collection"
    }
  }
}
Back to Top