Message Fields

AddNewLeadRequest

Name Database Info (Table.Column) Description
Leads N/A Array of requests to add new leads. See LeadInMsg[].
IgnoreDuplicates N/A Boolean value. Specifies whether or not to check for duplicates. For more information, see Code Samples.
ValidationTemplateId SyQuickLeadTemplate. SyQuickLeadTemplateId Specifies quick lead template validation to use. If not specified, the default template is used.
UseValidationTemplate N/A Boolean value. Specifies whether or not to use quick lead template validation.
TokenId N/A The security token for the request.

LeadInMsg[]

Name Database Info (Table.Column) Required Description
LastName SyStudent.LastName Yes Person's last name
FirstName SyStudent.FirstName Yes Person's first name
SchoolStatusId SyStudent.SySchoolStatusId Yes School status identifier
LeadDate SyStudent.LeadDate Yes Lead date
CampusId SyStudent.SyCampusId Yes Identifier for campus location
AdmissionsOfficerId SyStudent.AmRepId Yes Identifier for admissions representative
SSN SyStudent.SSN No Social Security Number
GenderId SyStudent.AmSexId No Person's gender (M or F)
LeadTypeId SyStudent.AmLeadTypeId No Identifier for the lead type
LeadSourceId SyStudent.AmLeadSrcId No Identifier for the lead source
Address SyStudent.Addr1 No Address of the lead
City SyStudent.City No City
StateId SyStudent.State No State
PostalCode SyStudent.Zip No Postal Code / ZIP

For details about the validation of postal codes, see Custom Validation for Postal Codes.

CountryId SyStudent.SyCountryId No Country identifier
CountyId SyStudent.SyCountyId No County identifier
Phone SyStudent.Phone No Home telephone number
WorkPhone SyStudent.WorkPhone No Work telephone number
WorkPhoneExtension SyStudent.Workext No Work telephone extension
MobileNumber SyStudent.MobileNumber Conditional Required when SubScribeToSMS = True.
AreaOfInterestId SyStudent.AdProgramGroupId No Identifier for Area of Interest (ProgramGroup)
ProgramIds AmProspectProgram.AdProgramId No Identifiers for Program(s) of Interest
AgencyId SyStudent.AmAgencyId No Identifier for Agency / Sponsor
HighSchoolGradDate AmProspectPrevEduc.HsGradDate No High school graduation date

Note: The Cmc.CampusLink.Soa.BusinessProcess.Master.config file can be edited to change the validation configurations for this field. For more information, see Validations for HighSchoolId, HighSchoolGradDate, and HighSchoolStudentLevel.

LeadId SyStudent.SyStudentId No Database identifier for the lead. For Qualified Leads this is the SyStudentId, for non-qualified it is the AmElectronicLeadsId.
AlienRegistrationNumber SyStudent.AlienNo No Alien registration number
BestTimeToContact SyStudent.BestTimeToContact No Best time of day to contact the lead.
BirthDate SyStudent.DOB No Person’s date of birth
CitizenshipId SyStudent.AmCitizenId No Citizenship identifier
CollegeId SyStudent.AmCollegeId No Row identifier for the college (if any) that the person is currently attending.
Comments SyStudent.Comment No Comments
CurrentEmployerId SyStudent.PlEmployerId No Current employer identifier
HasDisability SyStudent.Disabled No Does this person have a disability?
IsVeteran SyStudent.Vet No Is this person a veteran of the Armed Forces?
DriversLicenseNumber SyStudent.DrivLic No Driver’s license number
DriversLicenseStateId SyStudent.DrivLicState No Driver’s license state identifier
EMail SyStudent.Email No Email address
EmploymentStatusId SyStudent.plEmpStatusId No Current employment status identifier
ExpectedStartDate SyStudent.StartDate No Expected start date
ExtraCurricularIds AmProspectExtraCurr.
AmExtraCurrId
No Array of extra curricular identifiers
OtherEmail SyStudent.OtherEmail No Secondary email
NickName SyStudent.NickName No Person’s nick name
OtherPhone SyStudent.OtherPhone No Secondary phone number
PreviousEducationId AmProspectPrevEduc.
AmPrevEducId
No Previous education identifier
HighSchoolId   No High school identifier

Note: The Cmc.CampusLink.Soa.BusinessProcess.Master.config file can be edited to change the validation configurations for this field. For more information, see Validations for HighSchoolId, HighSchoolGradDate, and HighSchoolStudentLevel.

HighSchoolDateEnrolled AmProspectPrevEduc.
HSDateEnrolled
No High school date enrolled
HighSchoolGraduate AmProspectPrevEduc.
HSGraduated
No Is this lead a high school graduate? Boolean: True/False
HighSchoolGraduationSession AmProspectPrevEduc.
HSGraduationSession
No High school graduation session for this lead
HighSchoolGraduationYear AmProspectPrevEduc.
HSGradYear
No High school graduation year
HighSchoolLastDateAttended AmProspectPrevEduc.
HSLastDateAttended
No Last date attended high school
HighSchoolSize AmProspectPrevEduc.
HSSchoolSize
No High school size
HighSchoolStudentLevel AmProspectPrevEduc.
HSStudLevel
No High school student level

Note: The Cmc.CampusLink.Soa.BusinessProcess.Master.config file can be edited to change the validation configurations for this field. For more information, see Validations for HighSchoolId, HighSchoolGradDate, and HighSchoolStudentLevel.

HighSchoolStudentRank AmProspectPrevEduc.
HSStudRank
No High school student rank
HighSchoolTranscriptType AmProspectPrevEduc.
HSTranscriptType
No High school transcript type
MaidenName SyStudent.MaidenName No Person’s maiden name
MaritalStatusId SyStudent.AmMaritalId No Person’s marital status identifier
MiddleName SyStudent.MI No Middle name
SourceSystem SourceSystem No Indicates where the lead originated from (Database default: “C” for Anthology Student, M=MS CRM.
NationalityId SyStudent.AmNationalityId No Nationality identifier
IsHispanic SyStudent.IsHispanic No Is the person hispanic?
RaceIds SyStudentAmRace. OR AmElectronicsLeadsAmRace.
AmRaceId
No Database identifier for races
VerifiedLead none No Is this a verified lead? Verified are posted directly to the active lead table, non-verified go to the holding table (amElectronicLeads).
TitleId SyStudent.AmTitle No Person’s title
SuffixId SyStudent.Suffix No Person’s suffix
ShiftId SyStudent.AdShift No Person’s shift (morning/evening/etc.)
HSAcademicGPA SyStudent.HSAcademicGPA No GPA for high school academic courses
LeadVendorIds SyStudent.SyOrganizationId No Lead vendor identifier
SyStudentInquiryId SyStudentInquiry.
SyStudentInquiryId
No Database Identifier for the Student Inquiry
CRMSupressFlag N/A Yes It is a required flag. Values are false or true.

The CrmSuppressFlag is used in the CRM triggers on the syStudent table to determine if a record should be added to the CRM queue.

If Anthology is set up to integrate with CRM and a record is added/updated to syStudent with the CrmSuppressFlag set to false, the record will be added to the CRM queue.

If the CrmSuppressFlag is set to true, the record will not be added to the CRM queue.

The flag is only intended to be set to true on records coming from the Connector product to stop records that are coming from the CampusNexus CRM system from being sent back to CampusNexus CRM.

CMSMSServiceProviderID   Conditional SMS Service Provider Identifier

If the CMSMSServiceProviderID exists in the database but it is in "Inactive" state, a validation message states "Provided CMSMSServiceProviderID is inactive."

If provided value is not available in database, validation message “The value provided for property CMSMSserviceProviderId is invalid.“ is displayed.

SubscribeToSMS   No Boolean: True/False

If SubscribeToSMS is set to true, the CMSMSServiceProviderID and MobileNumber are required.

AddNewLeadResponse

Name Description
Leads Array of responses to add new lead request messages. See LeadOutMsg[].
Status Transaction Status
TrxResult Transaction Result
TokenId The security token for the request.

LeadOutMsg[]

Name Database Info (Table.Column) Description
LastName SyStudent.LastName Person's last name
FirstName SyStudent.FirstName Person's first name
SchoolStatusId SyStudent.SySchoolStatusId School status identifier
LeadDate SyStudent.LeadDate Lead date
CampusId SyStudent.SyCampusId Identifier for campus location
AdmissionsOfficerId SyStudent.AmRepId Identifier for admissions representative
SSN SyStudent.SSN Social Security Number
GenderId SyStudent.AmSexId Person's gender (M or F)
LeadTypeId SyStudent.AmLeadTypeId Identifier for the lead type
LeadSourceId SyStudent.AmLeadSrcId Identifier for the lead source
Address SyStudent.Addr1 Address of the lead
City SyStudent.City City
StateId SyStudent.State State
PostalCode SyStudent.Zip Postal Code / ZIP

For details about the validation of postal codes, see Custom Validation for Postal Codes.

CountryId SyStudent.SyCountryId Country identifier
CountyId SyStudent.SyCountyId County Identifier
Phone SyStudent.Phone Home telephone number
WorkPhone SyStudent.WorkPhone Work telephone number
WorkPhoneExtension SyStudent.Workext Work telephone extension
MobileNumber SyStudent.MobileNumber Mobile phone
AreaOfInterestId SyStudent.AdProgramGroupId Identifier for Area of Interest (ProgramGroup)
ProgramIds AmProspectProgram.AdProgramId Identifiers for Program(s) of Interest
AgencyId SyStudent.AmAgencyId Identifier for Agency / Sponsor
HighSchoolGradDate AmProspectPrevEduc.HsGradDate High school graduation date
LeadId SyStudent.SyStudentId Database identifier for the lead. For Qualified Leads this is the SyStudentId, for non-qualified it is the AmElectronicLeadsId.
AlienRegistrationNumber SyStudent.AlienNo Alien registration number
BestTimeToContact SyStudent.BestTimeToContact Best time of day to contact the lead.
BirthDate SyStudent.DOB Person’s date of birth
CitizenshipId SyStudent.AmCitizenId Citizenship identifier
CollegeId SyStudent.AmCollegeId Row identifier for the college (if any) that the person is currently attending.
Comments SyStudent.Comment Comments
CurrentEmployerId SyStudent.PlEmployerId Current employer identifier
HasDisability SyStudent.Disabled Does this person have a disability?
IsVeteran SyStudent.Vet Is this person a veteran of the Armed Forces?
DriversLicenseNumber SyStudent.DrivLic Driver’s license number
DriversLicenseStateId SyStudent.DrivLicState Driver’s license state identifier
EMail SyStudent.Email Email address
EmploymentStatusId SyStudent.plEmpStatusId Current employment status identifier
ExpectedStartDate SyStudent.StartDate Expected start date
ExtraCurricularIds AmProspectExtraCurr.AmExtraCurrId Array of extra curricular identifiers
OtherEmail SyStudent.OtherEmail Secondary email
NickName SyStudent.NickName Person’s nick name
OtherPhone SyStudent.OtherPhone Secondary phone number
PreviousEducationId AmProspectPrevEduc.AmPrevEducId Previous education identifier
HighSchoolId   High school identifier
HighSchoolDateEnrolled AmProspectPrevEduc.HSDateEnrolled High school date enrolled
HighSchoolGraduate AmProspectPrevEduc.HSGraduated Is this lead a high school graduate? Boolean: True/False
HighSchoolGraduationSession AmProspectPrevEduc.HSGraduationSession High school graduation session for this lead
HighSchoolGraduationYear AmProspectPrevEduc.HSGradYear High school graduation year
HighSchoolLastDateAttended AmProspectPrevEduc.HSLastDateAttended Last date attended high school
HighSchoolSize AmProspectPrevEduc.HSSchoolSize High school size
HighSchoolStudentLevel AmProspectPrevEduc.HSStudLevel High school student level
HighSchoolStudentRank AmProspectPrevEduc.HSStudRank High school student rank
HighSchoolTranscriptType AmProspectPrevEduc.HSTranscriptType High school transcript type
MaidenName SyStudent.MaidenName Person’s maiden name
MaritalStatusId SyStudent.AmMaritalId Person’s marital status identifier
MiddleName SyStudent.MI Middle name
SourceSystem SourceSystem Indicates where the lead originated from (Database default: “C” for Anthology Student, M=MS CRM.
NationalityId SyStudent.AmNationalityId Nationality identifier
IsHispanic SyStudent.IsHispanic Is the person Hispanic?
RaceIds SyStudentAmRace. OR AmElectronicsLeadsAmRace.AmRaceId Database identifier for races
VerifiedLead N/A Is this a verified lead? Verified are posted directly to the active lead table, non-verified go to the holding table (amElectronicLeads).
TitleId SyStudent.AmTitle Person’s title
SuffixId SyStudent.Suffix Person’s suffix
ShiftId SyStudent.AdShift Person’s shift (morning/evening/etc.)
HSAcademicGPA SyStudent.HSAcademicGPA GPA for high school academic courses
LeadVendorIds SyStudent.SyOrganizationId Lead vendor identifier
SyStudentInquiryId SyStudentInquiry.SyStudentInquiryId Database Identifier for the Student Inquiry
CRMSupressFlag N/A Boolean: True/False

The CrmSuppressFlag is used in the CRM triggers on the syStudent table to determine if a record should be added to the CRM queue.

If Anthology is set up to integrate with CRM and a record is added/updated in syStudent with the CrmSuppressFlag set to false, the record will be added to the CRM queue.

If the CrmSuppressFlag is set to true, the record will not be added to the CRM queue.

The flag is only intended to be set to true on records coming from the Connector product to stop records that are coming from the CampusNexus CRM system from being sent back to CampusNexus CRM.

CMSMSServiceProviderID   SMS Service Provider Identifier

If the CMSMSServiceProviderID exists in the database but it is in "Inactive" state, a validation message states "Provided CMSMSServiceProviderID is inactive."

SubscribeToSMS   Boolean: True/False

If SubscribeToSMS is set to true, the CMSMSServiceProviderID is required.