Fields

The REST API and SOAP API use different naming conventions for lead fields.

Retrieve the List of Field Names

You can retrieve the list of all supported field names available on your lead records by using the REST Describe Lead endpoint.

Where to Use Which Field Name Type?

Sometimes it is difficult to know which field name type that you need to use when leveraging a particular integration-related feature.  The following is a quick reference for which features use REST or SOAP field name types.

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

FAQs

Why does the REST API field sfdcId always return a value of null?

The field ‘sfdcId’ is a formula field which was erroneously included in the original field map for the REST API.  Records retrieved via the REST API do not compute the value of formula fields, so the value will always be null.  To capture the real SFDC ID, you should use the fields called ‘sfdcLeadId’ and ‘sfdcContactId’.