Lead Gen & CRM
How can we help you?
Search our help articles, video tutorials, and quickstart guides

You've got this. You've got us. Search our Knowledge Base to quickly find answers to your questions.

Understanding Lead Gen & CRM Open API Schema: Leads

Article: 000050881
Updated: July 9, 2024

A reference source for Lead Gen & CRM's lead-specific API

Lead Gen & CRM has a distinct API organization. This article will detail the parts of the Lead Gen & CRM API related to leads.


Article Contents

 

Users:
Administrators 
Company Managers  
Marketing Managers  
Sales Managers  
Salespersons  
Jr. Salespersons  

 

Lead

A lead is a prospect who is possibly interested in your product. As a lead progresses through your pipeline, their status changes from unqualified to qualified. A lead can be converted into a contact, opportunity, or account.

If you wish to update custom fields for a lead, specify the custom field's systemName as the key in your lead object. In order to get a list of system names, first retrieve members of the Field table. 
 

 

Name

TypeLengthIs Required
 idbigint20Optional
 accountIDbigint20Optional
 ownerIDbigint20Optional
 campaignIDbigint20Optional
 leadStatuspicklist Optional
 leadScoresmallint6Optional
 leadScoreWeightedsmaillint6Optional
 personastring128Optional
 activetinyint1Optional
 firstNamevarchar50Optional
 lastNamevarchar50Optional
 emailAddressvarchar150Required
 companyNamevarchar100Optional
 titlevarchar255Optional
 streetvarchar255Optional
 cityvarchar255Optional
 countryvarchar255Optional
 statevarchar50Optional
 zipcodevarchar50Optional
 websitevarchar255Optional
 phoneNumbervarchar255Optional
 trackingIDvarchar255Optional
 officePhoneNumbervarchar255Optional
 phoneNumberExtensionvarchar255Optional
 mobilePhoneNumbervarchar255Optional
 faxNumbervarchar255Optional
 descriptiontext Optional
 industryvarchar255Optional
 isUnsubscribedtinyint1Optional
 updateTimestamptimestamp Optional

 



Field

Contains metadata for a Lead Gen & CRM field. This includes both lead and opportunity fields. The systemName is a key that can be specified in any POST to create or update an object.
 

 

Name

TypeLengthIs Required
 idint18Optional
 relationshipvarchar255Required
 systemNamevarchar255Optional
 labelvarchar255Required
 sourcevarchar255Optional
 dataTypevarchar255Required
 dataLengthint18Required
 isRequiredtinyint1Required
 isCustomtinyint1Required
 isActivetinyint1Required
 isAvailableInContactManagertinyint1Required
 isEditableInContactManagertinyint1Required
 isAvailableInFormstinyint1Required

 


 

Additional API Information

This article details specific schema content about Lead Gen & CRM's API. However, given the size and scope of the API, information is broken up and is contained in different articles. Each article focuses on a specific function of Lead Gen & CRM's API. Additional API information can be found in the following articles:

 


Did this article answer your question?


Constant Contact Logo

Copyright © 2025 · All Rights Reserved · Constant Contact · Privacy Center