search
Contacts File

Last Updated:

Note: While email is not required for each contact, it is Beamery's best practice that all contacts be added with a valid email address.

 

Field Name Type Required Description Example

ID

String

:check_mark:

This is a unique identifier of the contact. The same ID must be used in supporting files in order for the data in those files to me tied to the contact.
Note: This ID is not imported into Beamery, it’s used as a reference for matching records from the other files.

efa64c3a-bb5c-4995-86d1-aec3722e7c27

FirstName

String

:check_mark:

The first name of the candidate

Joe

LastName

String

:check_mark:

The last name of the candidate.

Doe

MiddleNames

List of strings

 

List of candidate middle names separated by five (5) semicolons. Please remove all leading/trailing white space!

Percival;;;;;Wulfric;;;;;Brian

Emails

List of strings

 

List of candidate emails separated by five (5) semicolons. Please remove all leading/trailing white space!

joe.doe@beamery.com;;;;;joedoe@gmailcom

PhoneNumbers

List of strings

 

List of candidate phone numbers separated by five (5) semicolons. Please remove all leading/trailing white space!

01388000000;;;;;+44(0)7888888888

SocialLinks

List of strings

 

List of candidate social links separated by five (5) semicolons. Please remove all leading/trailing white space!

https://www.linkedin.com/in/pkilovatiy

Address

String

 

Candidate’s residential address

2701 Stacy Ln, Austin, TX 78704, USA

Country

String

 

Country associated with the address mentioned above

United States

Tags

List of strings

 

List of profile tags separated by five (5) semicolons. Please remove all leading/trailing white space!

Powerlifting;;;;;Anime;;;;Beamery Engineering

Languages

List of strings

 

List of contact’s spoken languages separated by five (5) semicolons. Please remove all leading/trailing white space!

British English;;;;;Japanese

Source

String

 

This is the human readable value of the Source of the contact.

Direct

Skills

List of strings

 

List of candidate skills separated by five (5) semicolons. Please remove all leading/trailing white space!

Java;;;;;Python;;;;;Project Management

GlobalTags

List of strings

 

List of Global Tags separated by five (5) semicolons. Please remove all leading/trailing white space!

Silver Medalist

Pool

String

 

Name of the talent pool where candidate should be added to. Pool must exist in customer’s tenant prior to validation/contact load.

Developers - North America

PoolStep

String

:warning:

Pool step is required for all pool types except for ‘General’ pool types.

Engaged

AssignedTo

String

 

Email address of the recruiter user account candidate should be assigned to. Such user must exist in the tenant.

joe.doe@beamery.com

GDPRConsent 

String

 

set the gdprConsent field on the profile. Must be either "TRUE" or "FALSE" case sensitive

New Field, please consult your IC if your company can use it

TRUE

GDPRConsentDate

String

 

set the gdprConsentDate field on the profile. Must in in ISO format;  format is "YYYY-MM-DDTHH:mm:ss.sssZ"

New Field, please consult your IC if your company can use it

2024-07-23T15:00:00.000Z

ContactType

String

 

sets the contact type field on the profile. Must be "internal", "external", & "alumni"

New Field, please consult your IC if your company can use it

internal

PrimaryEmail

String

 

sets the primary email on the profile in case more than one email exists.

If it's not provided then the first email in the Emails field is used as primary email

New Field, please consult your IC if your company can use it

joedoe@gmailcom