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:
|
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 |
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:
|
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:
|
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:
|
Array of strings | |
experienceLevel |
Current experience level of the contact. Possible values include the following:
|
string | 20 |
experience |
Companies where the contact has worked; this record can include multiple entries, including the following:
|
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:
|
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