Fields
The REST API and SOAP API use different naming conventions for lead fields. Use the field-name convention required by each integration feature.
Retrieve the List of Field Names
Use the REST ‘Describe Lead’ endpoint to retrieve all supported field names for lead records.
Where to Use Which Field Name Type?
The required field-name type depends on the integration feature. The following table identifies whether each feature uses REST or SOAP field names.
Feature
Field Name Type to Use
Lead Tracking API (Munchkin)
SOAP
Forms 2.0 API
SOAP
List Import (UI)
SOAP
List Import (REST API)
REST
Webhook Response Mappings
SOAP
Email Scripting (Velocity)
SOAP
SOAP API
SOAP
REST API
REST
Why does the REST API field sfdcId always return a value of null?
The sfdcId field is a formula field that was included in the original field map for the REST API. Records retrieved through the REST API do not compute formula field values, so sfdcId always returns null.
To retrieve the SFDC ID, use the sfdcLeadId and sfdcContactId fields.
recommendation-more-help
marketo-developer-help