Simple Survey Field Reference

This chart will help you understand the custom fields included with the Simple Survey application. This information will assist in including the appropriate fields in reports and list views, and give a broader understanding of each field's purpose.

  • Feb 13, 2026
  • Knowledge

Permalink
https://kb.vicasso.com/?kb=000004490
Details
 
 Simple Survey Object (Custom Managed Package Object)
Field LabelAPI NameField Description
Accountsimplesurvey__Account__cRelates the Survey to an Account.
Casesimplesurvey__Case__cRelates the Survey to a Case.
Contactsimplesurvey__Contact__cRelates the Survey to a Contact.
Net Promoter System℠simplesurvey__Net_Promoter_System__cIf the survey score is a six or below, this will be set to "Detractor".  If the score is seven or eight, it will be "Passive".  A nine or a ten will set the field to "Promoter".
NPS® Factorsimplesurvey__NPS_Factor__cUsed in reports and dashboards to calculate the Net Promoter Score®.  Set to -1 for Detractors, 0 for Passives, and 1 for Promoters.
Rating Scalesimplesurvey__Rating_Scale__cEither a 1-5 or 0-10 rating scale for the survey record.
Record Ownersimplesurvey__Record_Owner__cRelates to the User who owns the Account/Case/Contact that the survey was sent from.
Survey Commentssimplesurvey__Survey_Comments__cA packaged standard text field that can be used as a question (Why? Please provide some feedback.) on survey programs for customer feedback.
Survey Scoresimplesurvey__Survey_Score__cThis is the initial question of the survey and the survey score itself, with possible values being between the available values of the Rating Scale of the survey in question. Example: For an NPS survey, the score will be a value from 1 to 10, depending on what the respondent selects. 
Statussimplesurvey__Status__cThis field will be used to track the status of a survey and is reserved for future use. Status values include:
  • New: A survey record was created, not responded to, but will not be sent via Simple Survey's packaged Flow. This is used when local automation for sending surveys is configured outside the package.
  • Pending: The survey record has been created but not responded to.
  • Sent: The survey email was sent to the respondent through Simple Survey's packaged Flow. 
  • Not Sent: The survey email cannot be sent because the related contact/lead/user did not have a valid email address, or the user is inactive.
  • Fatigued: The survey record met the Survey Fatigue setting of the program and will not be sent to the respondent.
  • Responded: Customer has selected a rating / link in the initial survey email, but has not answered additional questions on the landing page.
  • Partial (only used if "Capture Partial Responses" is enabled): Customer has selected a rating / link in the initial survey email, has answered some (or all) questions on the landing page but has not clicked Submit Updates.
  • Completed: Customer has selected a rating / link in the initial survey email, has answered some (or all) questions on the landing page, and has clicked Submit Updates.
  • Expired: A survey record was pre-created, but the survey program expired before the survey could be sent via our packaged Flow.
  • Bounced: A survey email was not sent due to a bounced email address. Simple Survey will retry sending after 24 and 48 hours.
IP Addresssimplesurvey__IP_Address_2__cRecords the IP Address of the survey submitter.
Referrer    simplesurvey__Referrer__cThe URL of the page prior to the survey landing page loading.
User Agent    simplesurvey__User_Agent__cThe user agent of the survey submitter (name, version, and platform of the browser).
Human Confidence Scoresimplesurvey__Human_Confidence_Score__cRecords the Human Confidence Score of the survey record. Values closer to 1 represent a high confidence that the survey taker is human, while values closer to 0 indicate the likely involvement of an email scanner/bot. Negative values indicate connection errors or invalid Site/Secret Keys. 
Survey Unique Identifiersimplesurvey__SUID__cStores a secure unique identifier for survey records in order to improve security and prevent respondents from guessing the ID of other survey responses.
Survey URLsimplesurvey__Survey_Url__cStores the URL to provide to the recipient of a survey using the SUID. It is populated via the Survey Trigger in the package and automatically added to the "Send Information" section of the survey record page layout.
Send Attempt Failuressimplesurvey__Send_Attempt_Failures__cStores the number of times this survey was attempted to be sent but failed.
Survey Send Datesimplesurvey__Survey_Send_Date__cStores the time at which this survey was sent via email using Simple Survey’s built-in Flows.
Survey Send To (Contact)simplesurvey__Survey_Send_To_Contact__cStores the Contact to whom the Survey was sent.
Survey Send To (Lead)simplesurvey__Survey_Send_To_User__cStores the Lead to whom the Survey was sent.
Survey Send To (User)simplesurvey__Survey_Send_To_User__cStores the User to whom the Survey was sent.
Survey Typesimplesurvey__Survey_Type__cStores the type of the survey.
Snapshotsimplesurvey__Snapshot__cRich Text field that stores a visual representation of the survey responses.
Last Response Atsimplesurvey__Last_Response_At__cStores the last time the survey taker interacted with the Survey on the Landing Page.
Languagesimplesurvey__Language__cStores the language code of the language this survey was taken in.
Test Surveysimplesurvey__Is_Test_Survey__cWhen checked, the survey record is marked as test data and can be excluded from reports and live data analysis.
 
Case Object
Field NameAPI NameDescription
Survey Sentsimplesurvey__Survey_Sent__cFor tracking the most recent survey date on the Case. 

 
Contact Object
Field NameAPI NameDescription
Survey Last Requested Onsimplesurvey__Survey_Last_Requested_On__cFor tracking the most recent survey date on the Case that the Contact is related to. This field can be utilized in local automation to prevent "survey fatigue" for Case Contacts.

 

Lead Object
Field NameAPI NameDescription
Survey Last Requested Onsimplesurvey__Survey_Last_Requested_On__cFor tracking the most recent survey date on the Case that the Lead is related to. This field can be utilized in local automation to prevent "survey fatigue" for Case Leads.

 

User Object
Field NameAPI NameDescription
Survey Last Requested Onsimplesurvey__Survey_Last_Requested_On__cFor tracking the most recent survey date on the Case that the User is related to. This field can be utilized in local automation to prevent "survey fatigue" for Users.


Net Promoter, Net Promoter System, Net Promoter Score, and NPS are trademarks of Satmetrix Systems, Inc., Bain & Company, Inc., and Fred Reichheld and are being used under license.

Title
Simple Survey Field Reference
URL Name
Simple-Survey-Field-Reference