Contact Fields in Exported Records

All Standard and customer-specific Custom contact fields that contain data are exported with the related contact record.

All fields that are available for import through the Contact Import API are available for extraction through the Contact Export API, including Standard and Custom fields, Lists, Tags, and Global and List Statuses.​

Standard Contact Fields

Following are the Standard contact fields that will be exported through the API if they contain data when the record is exported. Custom fields vary by implementation; Administrator users can view their custom fields in the SmashFly Configuration module under Contacts > Custom Fields.

Note: These fields are exported only if they contain data on the contact record at the time of the export.

Field Name Description Data Type Length
id Contact's ID number in SmashFly. string  

firstName

Contact's first name. string 50
lastName The contact’s last name (surname). string 50
addedOn Date when the contact was added to SmashFly. string  
addedBy User who added the contact to SmashFly. string  
updatedOn Date when the contact was last updated in the SmashFly Console. string  
updatedBy User who updated the contact in the SmashFly Console. string  
globalStatus

Contact's global statuses. Each record includes the following:

  • status: Global status
  • note: Note added when changing the status
  • updatedOn: Date when the global status was updated to this status
  • updatedBy: User who updated the global status
Array of strings  
jobTitle Current / most recent job title for the contact. string 150
company Current / most recent company at which the contact has worked. string 150
email Primary email address for the contact. string 120
otherEmail Alternate email address for the contact. string 120
address1 Address of the contact. string 200
address2 Address (additional line) of the contact. string 200
city City of the contact's address. string 50
state The code of the contact’s state of residence or location (for example, CA for California). Codes are different for North America and areas outside of North America. string 50
country Country code for the contact's mailing address. string 50
postalCode Postal code of the contact's address. string 50
homePhone Primary phone number for the contact. string 50
workPhone Work phone number for the contact. string 50
mobilePhone Mobile phone number for the contact. string 30
method

Mechanism through which the contact was added to a SmashFly contact database. SmashFly detects and assigns the method automatically.

Methods include the following:

  • API – if contact came in via the Contact API
  • Contact Form – if contact came from a Talent Form that is not used in a job apply flow
  • Email Inhaler – if contact was added via web import GrabIt! – if contact was added via GrabIt!
  • Manually Added – if contact was added manually
  • Opt In – if contact came from a Job Opt In Talent Form
  • SMS – if contact was added via SMS (via a very rarely used process)
  • Web Import – if contact was added via Import Resumes, Import Spreadsheet, or a Batch File-based Integration
  • Web Sourcing – if contact was added via a fully integrated web sourcing channel (any channel other than OpenWeb)
string  
source

Source (or marketing tactic) with which the contact is associated.

Examples are Linkedin, Indeed, Monster, Twitter, Facebook, Email Campaign, Referral, and Job Alert.

Sources are date and time stamped on a contact's record every time they are tracked. Sources are largely auto-detected and associated with a contact as they are detected, but they can also be manually specified by a SmashFly user who is editing or creating a contact.​

string 75
jobCode Job category that the contact best fits in. string  
school Current or most recent school attended by the contact. string 250
educationLevel

Highest level of education the contract has received. Possible values include the following:

  • Bachelor of Science
  • Bachelor of Arts
  • Master of Science
  • Master of Arts
  • Medical Doctor
  • MBA
  • MFA
  • PHD
  • Other
string 20
education

An array of strings that describe the degree the contact has received or is in progress of earning. (The Education node may include multiple records.) Each record includes the following:

  • school: School the contact is attending or has attended
  • major: Academic major
  • degree: Academic degree the user is earning or has earned
  • gradYear: Year the contact graduated or is expected to graduate
  • hasGraduated: Whether the contact has graduated from this school (true or false)
Array of strings  
experienceLevel

Current experience level of the contact. Possible values include the following:

  • Student
  • Entry Level
  • Experienced
  • Manager
  • Executive
  • Senior Executive
string 20
experience

Companies where the contact has worked; this record can include multiple entries, including the following:

  • company: Name of the company
  • position: Job title of the position the contact held at this company
  • start: Date when the contact started working at this company
  • end: Date when the contact stopped working at this company
  • supervisor: Name of the contact's supervisor at this company
  • supervisorTitle: Title of the position held by the contact's supervisor at this company
  • state: State in which the company was located
string  
facebookProfile URL to the contact’s Facebook page. string 150
linkedInProfile The contact’s LinkedIn Profile URL. string 250
twitterProfile The URL to the contact’s Twitter profile. string 100
url URL to a website associated with the contact (for example, a deep link to an ATS profile or the contact’s personal web page) string 150
isApplicant True/False. Specifies whether the contact is already an applicant in the ATS system. boolean  
isReferral True/False. Specifies whether the contact was referred by a sponsor. boolean  
canReceiveEmail True/False. Specifies whether the contact can receive Email from the SmashFly Console. boolean  
canReceiveSMS True/False. Specifies whether the contact can receive SMS messages from the SmashFly Console. boolean  
userScore Numeric rating of the contact, using numbers 1 through 5. string  
[Custom fields] Any custom fields on the contact record that contain data at the time of the export. string  
lists

All contact, event, or job lists with which the contact is associated. It includes the following:

  • id: List ID
  • name: List name
  • active: Whether the list is active (0 = active; 1 = inactive)
  • contactStatus: Current status of the contact within the list
JSON collection  
tags

Any tags included on the contact record; this node appears only if the Tags parameter is included in the request. Tags are returned as a JSON collection.

JSON collection  
talentForms Any talent forms included on the contact record; this node appears only if the TalentForm parameter is included in the request. Talent Forms are returned as a JSON collection. JSON collection  
resume The full text/HTML of the contact’s resume. This is returned only if the request is for the resume, and it is accompanied by the contact ID. This field is not included with the contact request. HTML  
expunge True/false. Specifies whether the contact has been flagged to be expunged from the system. boolean  

Note: Some fields in the Contact Search response are named differently to the response in the other API responses. These are noted below:

Field Name Contact Search Field Name
Id ContactId
OtherEmail HomeEmail
mobilePhone MobileNumber
method Source
source SecondarySource
url webUrl
isReferral iSReferred
canReceiveEmail receiveEmail
canReceiveSMS receiveSMS
expunge toBeExpunged

Currently through the Contact Search you cannot retrieve data for the following general fields:

  • GlobalStatus – note, updatedOn and updatedBy – instead the GlobalStatus is returned as a string equivalent to the status value of the global status returned in the other requests.
  • Job Code – not available
  • Education – Education Level and school are available.
  • Experience – Experience level is available.
  • Lists
  • Tags
  • TalentForms
  • Resume