Onboarding New Hires Integration Process

UKG Pro Web Services API Guide

Onboarding New Hires Integration Process

Introduction

With web services, you can leverage your UKG Pro Onboarding solution data for solving business application and integration needs.

The UKG Identity team registers the Partner or Customer Integration App with Onboarding using an offline process. The integration must first be enabled for this tenant using UKG’s offline process. You can then enable the Partner or Customer Integration through Onboarding’s user interface (Settings > Integration Menu).

UKG provides the following integration details:

  • API authentication information:
    • Identity Host – provided for test or production clusters by the UKG Identity team
    • Grant Type – grant_type: client_credentials
    • OAuth Client ID – Client_id provided by the UKG Identity team
    • Client Secret – Client_secret provided by the UKG Identity team
    • Scope: Onboarding

Note: You must create a support case to request a Client ID and Client Secret to access this API.

  • Cluster URLs for all production clusters
    • Note: For development or testing, a sandbox environment URL is sufficient.
  • Tenant aliases
    • Note: For development or testing, the sandbox tenant alias is sufficient.

Review the Recruiting and Onboarding API Authentication Guide in the Learning Center for details on required authentication information and lists of data centers.

Security Data Flow

UKG Pro Identity (UPI) provides Authentication and Authorization for the systems. The UPI authentication process involves validating credentials or tokens and extracting claims about the identity. The goal of the Authentication process is to generate a principal (in the security sense) with all the necessary information needed to perform the authorization.

With UKG Pro Identity, authentication is handled using JWT Bearer tokens. Every New Hire API call needs an authorization token that must be passed in the header as follows:

Authorization: Bearer <token>
  • Application requests the OAuth token from UKG Pro Identity by providing their Client ID and Client Secret.
  • UKG Pro Identity verifies the credentials and returns an authorization token if they are valid.
  • An OAuth token can be cached and reused. The OAuth token lifetime is returned in the expires_in field.

The UKG Pro Identity authorization process involves correlating the identity to the resources requested. This process starts by validating the token and then verifying if the principal has the required access roles. If the principal has the required roles, the authorization is granted. Internally, UKG Pro Identity manages these credentials via the definitions of Scopes and Entitlements.

Onboarding API URLs

For the integration to connect to the correct UKG Pro Onboarding APIs, integration developers need the following required information:

  • Onboarding URL – to map to the correct endpoint URL
  • Tenant alias for the customer(s) company

This information is visible from the Onboarding URL itself. For example, ACA100 is the tenant alias in the following URL: https://onboarding.ultipro.com/ACA100/SignIn.

POST/Tenants/{TenantIdentifier}/New-Hires

This section contains information about the POST /Tenants/{TenantIdentifier}/New-Hires method.

Resource URL

POST https://{{onb-host}}/talent/onboarding/v2/tenants/{{tenant-identifier}}/new-hires

Request Parameters

NameRequired or OptionalDescription
tenantIdentifierRequiredUnique identifier of the tenant to interact with. Can be either the tenant alias or tenant ID. A tenant usually represents a single customer.
bodyRequiredNew Hire object to be added. See below for details.

Body

Best Practices:

  • We recommend providing the Job for all hires.
  • These validations exist in the API:
    • When sending a Component Company, a Job must also be provided.
    • Job and Component Company must be in the same country.
    • When sending a Work Location, you are required to send a Component Company and a Job.
    • Work Location must be valid for the Component Company.
    • If you do not have Component Company, Work Location, or Job information on the hire, we recommend assigning an Onboarding Owner in the POST.
  • Anywhere there is an Id and Code, you only need to send one or the other. Code is the recommended field.

Note: In the table below, where there is an ID and Code listed, you only need to send one or the other, not both. Code is the recommended field.

FieldRequired or OptionalMax LengthDescription
ContactInformation-Contact information for the new hire
name-Name of the new hire
prefix-Prefix of the new hire
idOptionalstringUnique identifier of the prefix
codeOptionalstringUKG Pro prefix code
firstRequired50/100First name of the new hire. For international hires (based on country of component company), max length is 100. All other hires accept 50 characters.
middleOptional50Middle name of the new hire
lastRequired50/100Last name of the new hire. For international hires (based on country of component company), max length is 100. All other hires accept 50 characters.
formerLastOptional30/100Former last name of the new hire. For international hires (based on country of component company), max length is 100. All other hires accept 30 characters.
suffix-Suffix of the new hire
idOptionalstringUnique identifier of the suffix
codeOptionalstringUKG Pro suffix code
preferredFirstOptional50/100Preferred first name of the new hire. For international hires (based on country of component company), max length is 100. All other hires accept 50 characters.
emailaddressRequired254Email address of the new hire
primaryPhoneOptional50Primary phone number of the new hire. If hire’s address country code is provided as USA or CAN, correct phone number format is validated.
secondaryPhoneOptional50Secondary phone number of the new hire. If hire’s address country code is provided as USA or CAN, correct phone number format is validated.
address-Address of the new hire
line1Optional100/255Line 1 of the address. If hire’s address country code is provided as USA or CAN, max length is 100.
line2Optional100/255Line 2 of the address. If hire’s address country code is provided as USA or CAN, max length is 100.
cityOptional50/255City of the address. If hire’s address country code is provided as USA or CAN, max length is 50.
postalCodeOptional50Zip/postal code of the address. If hire’s address country code is provided as USA or CAN, correct postal code format is validated.
countyOptional30/255County of the address. If hire’s address country code is provided as USA or CAN, max length is 30.
stateCodeOptionalState code of the address. Note: State code is used to determine US live-in tax forms and it is recommended to send the state code of the hire.
countryCodeOptionalISO country code of the address. Note: If stateCode is sent, countryCode must also be sent.
onboardingOwnerIdOptional/ConditionalstringExternal user identifier of the Onboarding Owner. Required if not providing Job, Component Company, or Work Location.
hireDateOptionalstring($date-time)Hire date of the new hire
startDateOptionalstring($date-time)
pastStartDateReasonOptionalstring250
orientationDateOptionalstring($date-time)
compensation-
fullTimeOptionalboolean
salariedOptionalboolean
workHoursOptionalnumber
weeklyHoursOptionalnumber168.0
currencyCodeOptionalstring
payRateOptionalnumber
ratePerOptionalstring
job-
idOptional/Conditionalstring
codeOptional/Conditionalstring
requisitionIdOptionalstring50
componentCompany-
idOptionalstring
codeOptionalstring
workLocation-
idOptional/Conditionalstring
codeOptional/Conditionalstring
supervisor-
idOptionalstring
codeOptionalstring
employeeType-
idOptionalstring
codeOptionalstring
selectedFLSAStatusOptionalinteger
organizationLevels-
idOptionalstring
levelOptionalinteger
codeOptionalstring
mentor-
idOptionalstring
codeOptionalstring
descriptionOptionalstring85
personalMessageOptionalstring250

Sample Request JSON

{
"contactInformation": {
        "name": {
            "prefix": {
                "code": "MR"
            },
            "first": "Hugo",
            "middle": "Alexander",
            "last": "Mastrantonioni",
            "formerLast": "",
            "preferredFirst": "Hugh",
            "suffix": {
                "code": "III"
            }
        },
        "primaryPhone": "3056985433",
        "secondaryPhone": "3056986533",
        "address": {
            "line1": "123 Main St",
            "line2": "345 Side Rd",
            "city": "Rosemead",
            "postalCode": "A1A2B2",
            "county": "Bruce County",
            "stateCode": "ON",
            "countryCode":"CAN"
        },
        "emailAddress": "[email protected]"
    },
    "onboardingOwnerId": "74A3D0C8-FF2A-4EC9-9263-F515B000A0C5",
    "hireDate": "06/23/2018",
    "startDate": "06/30/2018",
    "orientationDate": "07/06/2018",
    "pastStartDateReason": "An internal audit revealed that the new hire was not initiated ",
    "compensation": {
        "fullTime": true,
        "salaried": true,
        "workHours": 40,
        "weeklyHours": 32,
        "currencyCode": "CAD",
        "payRate": 35,
        "ratePer": "H"
    },
    "job": {
        "code": "DJOB",
        "requisitionId": "DEV30335",
        "selectedFLSAStatus": "2",
        "componentCompany": {
            "code": "WAYNEENT"
        },
        "workLocation": {
            "code": "TORHQ”
        },
        "employeeType": {
            "code": "CM1"
        },
        "supervisor": {
            "code": "BF5DAEBD-9149-40BB-9AB3-C4755F98F4D0"
        }
    },
    " organizationLevels": [
              {
      		    "level": 1,
                 "code": "PROD"
              },
              {
                 "level": 2,
                 "code": "PR"
              },
              {
      		    "level": 3,
                 "code": "STAT"	
              },
              {
                 "level": 4,
                 "code": "SALES"
              },
          ]

    "mentor": {
    	"code":"145A494C-DAFD-4454-881C-6700C85512C8",
    	"description": "Oden is THE person who knows the product best. She loves helping new team members."
    },
    "personalMessage": "Hugo, I was very impressed with your passion. I am looking forward to working with you and I know your expertise in this space will help our team get to the next level."
}

Sample Response JSON

{
  "contactInformation": {
    "name": {
      "prefix": {
        "id": "d9079570-57f0-4530-b889-a07c95acb846",
        "name": {
          "enUS": "Mr."
        }
      },
      "first": "Hugo",
      "middle": "Alexander",
      "last": "Mastrantonioni",
      "formerLast": "",
      "suffix": {
        "id": "99ace441-e900-4a4c-9731-c97ea8451482",
        "name": {
          "enUS": "III"
        }
      },
      "preferredFirst": "Hugh"
    },
    "emailAddress": "[email protected]",
    "primaryPhone": "3056985433",
    "secondaryPhone": "3056986533",
    "address": {
      "line1": "123 Main St",
      "line2": "345 Side Rd",
      "city": "Rosemead",
      "postalCode": "A1A2B2",
      "county": "Bruce County",
      "stateCode": "ON",
      "countryCode": "CAN"
      "code": "CAN",
      "name": {
        "enUS": "Canada"
         }
       },
    
  "job": {
    "id": "96a5833e-5f4b-46b0-ac58-41dba1e4aa1b",
    "code": "DJOB",
    "name": {
      "enUS": "Lead Tech",
      "esES": "Tecnico Principal"
    },
    "requisitionId": "DEV30335",
    "selectedFLSAStatus": 2,
    "supervisor": {
      "id": "28e2f53b-2366-4aef-98f0-f8b765bb9f7a",
      "name": {
        "prefix": {
          "id": "d9079570-57f0-4530-b889-a07c95acb846",
          "name": {
            "enUS": "Mr."
          }
        },
        "first": "Joe",
        "middle": "Jose",
        "last": "Santo",
        "formerLast": "",
        "suffix": {
          "id": "99ace441-e900-4a4c-9731-c97ea8451482",
          "name": {
            "enUS": "Jr"
          }
        },
        "preferredFirst": "Joseph"
      },
      "email": "[email protected]",
      "externalUserId": "BF5DAEBD-9149-40BB-9AB3-C4755F98F4D0"
    },
    "componentCompany": {
      "id": "f7bbaf0c-d703-4b46-8ef2-8ea62e9319c4",
      "name": "Wayne Enterprises"
    },
    "workLocation": {
      "id": "b3ee9042-43be-4a9d-aa03-1ef2d41153f9",
      "name": "Toronto Headquarters"
    },
    "employeeType": {
      "id": "8ccb43fd-686b-4cbb-abb3-ced359148ae1",
      "name": {
        "enUS": "Comp Mgt 1-Reg"
      }
    }
  },
  "compensation": {
    "isFullTime": true,
    "isSalaried": true,
    "workHours": 40,
    “weeklyHours”: 32,
    “currencyType": "CAD",
    “currency”: {
          "code": "CAD",
          "name": {
            "enUS": "Canadian Dollar"
           }
     },
    "payRate": 35”
    “ratePer”: {
        "code": "H",
        "name": {
          "enUS": "Hour"
    
	}
      }
  },
  "mentor": {
    "id": "56f378ee-90d4-44ec-9ab7-83f2437d1fe6",
    "name": {
      "prefix": {
        "id": "d9079570-57f0-4530-b889-a07c95acb846",
        "name": {
          "enUS": "Mr."
        }
      },
      "first": "Oden",
      "middle": "Joe",
      "last": "Leonerd",
      "formerLast": "",
      "suffix": {
        "id": "99ace441-e900-4a4c-9731-c97ea8451482",
        "name": {
          "enUS": "III"
        }
      },
      "preferredFirst": "Kevin"
    },
    "email": "[email protected]",
    "description": "Oden is THE person who knows the product best. She loves helping new team members.",
    "externalUserId": "145A494C-DAFD-4454-881C-6700C85512C8"
  },
  "onboardingOwner": {
    "id": "2d42c7a5-52de-402e-92af-493b5b7f0682",
    "name": {
      "prefix": {
        "id": "d9079570-57f0-4530-b889-a07c95acb846",
        "name": {
          "enUS": "Mr."
        }
      },
      "first": "Jared",
      "middle": "Joseph",
      "last": "Nalin",
      "formerLast": "",
      "suffix": {
        "id": "99ace441-e900-4a4c-9731-c97ea8451482",
        "name": {
          "enUS": "III"
        }
      },
      "preferredFirst": "Jared"
    },
    "email": "[email protected]",
    "externalUserId": "74A3D0C8-FF2A-4EC9-9263-F515B000A0C5"
  },
  "onboardingStatus": "Launched",
  "sentToProcessHireDate": {
    "utcInstant": "2018-06-07T17:44:25.358Z",
    "offset": "-04:00:00"
  },
  "launchedOn": {
    "utcInstant": "2018-06-07T17:44:25.358Z",
    "offset": "-04:00:00"
  },
  "hireDate": "2018-06-23T00:00:00Z",
  "orientationDate": "2018-07-06T00:00:00Z",
  "startDate": "2018-06-30T00:00:00Z",
  "organizationLevels": [
    {
      "id": "b7a43db9-73c7-43d6-aaab-7b2bc20ed50f",
      "level": 1,
      "code": "PROD",
      "description": "Product division"
    },
    {
      "id": "8e4507db-330b-466d-8786-9f55da5f6c31",
      "level": 2,
      "code": "PR",
      "description": "Public relations"
    },
    {
      "id": "2bf4a848-2926-485f-aa47-4aa8db90921b",
      "level": 3,
      "code": "STAT",
      "description": "Stanton branch"
    },
    {
      "id": "3c792567-7494-4f84-91ae-73c797c714ef",
      "level": 4,
      "code": "SALES",
      "description": "Sales team"
    }
  ],
  "provisioning": {
    "provisioningItems": [
      {
        "id": "9977e393-3e7a-4044-a8f9-d8c3f6ef0de2",
        "name": "Corporate Credit Card",
        "recipient": "[email protected]",
        "selectedOption": {
          "id": "a4971b36-e8a3-43c8-b163-27c6d9dfbb98",
          "description": "Amex Card"
        },
        "comments": "Requires a platinum Amex Card"
      },
      {
        "id": "1f9c7b77-18b3-4ab7-b9cb-03790c0dc4bd",
        "name": "Network Account",
        "recipient": "[email protected]",
        "selectedOption": {
          "id": "3c792567-7494-4f84-91ae-73c797c714ef",
          "description": "Super Account"
        },
        "comments": "Highest clearance"
      },
      {
        "id": "add33aee-ebff-4d50-8f45-9d7ab820c053",
        "name": "Phone Type",
        "recipient": "[email protected]",
        "selectedOption": {
          "id": "05882bc4-7ae6-40b5-b1ee-2e56dd37bb49",
          "description": "Galaxy S5"
        },
        "comments": "Requires a black phone"
      }
    ],
    "summaryEmailRecipients": [
      "[email protected]",
      "[email protected]",
      "[email protected]"
    ]
  },
  "identityUserId": "05882bc4-7ae6-40b5-b1ee-2e56dd37bb49",
  "externalUserId": "b7a4fd34-73c7-43d6-aaab-7b2bc20ed50f",
  "personalMessage": "Hugo, I was very impressed with your passion. I am looking forward to working with you and I know your expertise in this space will help our team get to the next level.",
  "pastStartDateReason": "An internal audit revealed that the new hire was not initiated",
  "id": "05882bc4-7ae6-40b5-b1ee-2e56dd37bb49",
  "createdAt": "2018-05-29T19:30:35.95Z",
  "updatedAt": "2018-06-07T17:44:25.378Z"
}

GET/Tenants/{TenantIdentifier}/New-Hires/{ID}

This section contains information about the GET /Tenants/{TenantIdentifier}/New-Hires/{ID} method.

Resource URL

GET https://{{onb-host}}/talent/onboarding/v2/tenants/{{tenant-identifier}}/new-hires/{{new-hire-id}}

sql
Copy code

Request Parameters

NameRequired or OptionalDescription
tenantIdentifierRequiredUnique identifier of the tenant to interact with. Can be either the tenant alias or tenant ID. A tenant usually represents a single customer.
idRequiredUnique identifier for the new hire.

Response Parameters

FieldField TypeDescription
idstringUnique identifier of the new hire
contactinformation-Contact information for the new hire
name-Name of the new hire
prefix-Prefix of the new hire in translatable format
idstringID of the prefix
namestringName of the prefix Note: Could be returned in several languages
firststringFirst name of the new hire
middlestringMiddle name of the new hire
laststringLast name of the new hire
formerLaststringFormer last name of the new hire
suffix-Suffix of the new hire in translatable format
idstringID of the suffix
namestringName of the suffix Note: Could be returned in several languages
preferredFirststringPreferred first name of the new hire
emailaddressstringEmail address of the new hire
primaryPhonestringPrimary phone number of the new hire
secondaryPhonestringSecondary phone number of the new hire
address-Address of the new hire
line1stringLine 1 of the address
line2stringLine 2 of the address
citystringCity of the address
postalCodestringZip/postal code of the address
countystringCounty of the address
stateCodestringState code of the address
countryCodestringCountry code of the address
country-
codestringISO Code of the address country
namestringName of the country Note: Could be returned in several languages
onboardingOwner-Onboarding Owner for the new hire
idstringID of the Onboarding Owner
externalUserIdstringExternal user identifier of the Onboarding Owner
emailstringEmail of the Onboarding Owner
name-Name of the Onboarding Owner
prefix-Prefix of the Onboarding Owner in translatable format
idstringID of the prefix
namestringName of the prefix Note: Could be returned in several languages
firststringFirst name
middlestringMiddle name
laststringLast name
formerLaststringFormer Last Name
suffix-Suffix of the Onboarding Owner in translatable format
idstringID of the suffix
namestringName of the suffix Note: Could be returned in several languages
preferredFirststringPreferred first name
hireDatestring($date-time)Hire date of the new hire
startDatestring($date-time)Start date of the new hire
pastStartDateReasonstringReason why the new hire start date is 4 or more business days in the past
orientationDatestring($date-time)Orientation date of the new hire
compensation-Compensation information for the new hire
isFullTimebooleanWhether the new hire is full time
isSalariedbooleanWhether the new hire is salaried
workHoursnumberWork hours of the new hire
weeklyHoursnumberWeekly hours of the new hire
currencytypestringCurrency type of the new hire’s pay
currency-Currency code for the pay rate of the new hire
codestringUnique identifier of the currency code
namestringName of the currency Note: Could be returned in several languages
payRatenumberPay rate of the new hire
ratePer-Pay frequency of the new hire
codestringUnique identifier of the pay frequency
namestringName of the pay frequency Note: Could be returned in several languages
job-Job information for the new hire
idstringUnique identifier of the job
namestringThe name of the job
codestringCode of the job
requisitionIdstringRequisition Id of the job
selectedFLSAStatusintegerSelected FLSA status for the job. Enum: [Not specified = 0, Exempt = 1, NonExempt = 2]
componentCompany-Component company of the job
idstringUnique identifier of the component company
namestringName of the component company
workLocation-Work location of the job
idstringUnique identifier of the work location
namestringName of the work location
supervisor-Supervisor of the job
idstringID of the supervisor
name-Name of the supervisor
prefix-Prefix of the supervisor in translatable format
idstringID of the prefix
namestringName of the prefix Note: Could be returned in several languages
firststringFirst name
middlestringMiddle name
laststringLast name
formerLaststringFormer last name
suffix-Suffix of the supervisor in translatable format
idstringID of the suffix
namestringName of the suffix Note: Could be returned in several languages
preferredFirststringPreferred first name
emailstringThe email of the supervisor
externalUserIdstringThe external user ID of the supervisor
employeeType-Employee type for the job
idstringID of the employee type
namestringName of the employee type Note: Could be returned in several languages
organizationLevels-Organization level
idstringIdentifier of the organization level
levelintegerLevel of the organization level. Enum: [Level 1 = 1, Level 2 = 2, Level 3 = 3, Level 4 = 4]
codestringUnique code of an organization that the new hire is associated with
descriptionstringDescription of an organization that the new hire is associated with
mentor-Mentor of the new hire
idstringID of the mentor
externalUserIdstringExternal user identifier of the mentor
emailstringEmail of the mentor
name-Name of the mentor
prefix-Prefix of the mentor in translatable format
idstringID of the prefix
namestringName of the prefix Note: Could be returned in several languages
firststringFirst name
middlestringMiddle name
laststringLast name
formerLaststringFormer Last name
suffix-Suffix of the mentor in translatable format
idstringID of the suffix
namestringName of the suffix Note: Could be returned in several languages
preferredFirststringPreferred first name
descriptionstringDescription of the mentor
provisioning-Provisioning for the new hire
provisioningItems-The list of provisioning items selected for this New Hire
--An individual provisioning item that is assigned to a new hire
idstringID of the provisioning item
namestringCategory of the provisioning item
recipientstringRecipient of the provisioning item
selectedOption-Selected option for the provisioning item
idstringUnique identifier of the Option
descriptionstringDescription of the Option
commentsstringComment on the provisioning item
summaryEmailRecipients-These emails receive updates about this new hire’s provisioning items
stringAn individual email that receives updates on the new hire’s provisioning items
onboardingStatusstringThe status of the new hire in Onboarding
identityUserIdstringIdentity user identifier of the new hire
externalUserIdstringExternal user identifier of the new hire
employeeNumberstringEmployee number of the new hire
createdAtstring($date-time)Creation date of the new hire
updatedAtstring($date-time)Last updated date of the new hire
sentToProcessHireDatestring($date-time)Date that the new hire was processed
launchedOnstring($date-time)Launch date of the new hire

Sample Response JSON

{
  "contactInformation": {
    "name": {
      "prefix": {
        "id": "d9079570-57f0-4530-b889-a07c95acb846",
        "name": {
          "enUS": "Mr."
        }
      },
      "first": "Hugo",
      "middle": "Alexander",
      "last": "Mastrantonioni",
      "formerLast": "",
      "suffix": {
        "id": "99ace441-e900-4a4c-9731-c97ea8451482",
        "name": {
          "enUS": "III"
        }
      },
      "preferredFirst": "Hugh"
    },
    "emailAddress": "[email protected]",
    "primaryPhone": "3056985433",
    "secondaryPhone": "3056986533",
    "address": {
      "line1": "123 Main St",
      "line2": "345 Side Rd",
      "city": "Rosemead",
      "postalCode": "A1A2B2"
      "county": "Bruce County",
      "stateCode": "ON",
      "countryCode": "CAN",
      "country": {
          "code": "CAN",
          "name": {
            "enUS": "Canada",
    }
  },
  "job": {
    "id": "96a5833e-5f4b-46b0-ac58-41dba1e4aa1b",
    "code": "DJOB",
    "name": {
      "enUS": "Lead Tech",
      "esES": "Tecnico Principal"
    },
    "requisitionId": "DEV30335",
    "selectedFLSAStatus": 2,
    "supervisor": {
      "id": "28e2f53b-2366-4aef-98f0-f8b765bb9f7a",
      "name": {
        "prefix": {
          "id": "d9079570-57f0-4530-b889-a07c95acb846",
          "name": {
            "enUS": "Mr."
          }
        },
        "first": "Joe",
        "middle": "Jose",
        "last": "Santo",
        "formerLast": "",
        "suffix": {
          "id": "99ace441-e900-4a4c-9731-c97ea8451482",
          "name": {
            "enUS": "Jr"
          }
        },
        "preferredFirst": "Joseph"
      },
      "email": "[email protected]",
      "externalUserId": "BF5DAEBD-9149-40BB-9AB3-C4755F98F4D0"
    },
    "componentCompany": {
      "id": "f7bbaf0c-d703-4b46-8ef2-8ea62e9319c4",
      "name": "Wayne Enterprises"
    },
    "workLocation": {
      "id": "b3ee9042-43be-4a9d-aa03-1ef2d41153f9",
      "name": "Toronto Headquarters"
    },
    "employeeType": {
      "id": "8ccb43fd-686b-4cbb-abb3-ced359148ae1",
      "name": {
        "enUS": "Comp Mgt 1-Reg"
      }
    }
  },
  "compensation": {
    "isFullTime": true,
    "isSalaried": true,
    "workHours": 40,
    “weeklyHours”: 32,
    
    "currencyType": "CAD" ,
    “currency”: {
          "code": "CAD",
          "name": {
            "enUS": "Canadian Dollar",
           }
     },    "payRate": 35”
    “ratePer”: {
        "code": "H",
        "name": {
          "enUS": "Hour"
          }
      }
  },
  "mentor": {
    "id": "56f378ee-90d4-44ec-9ab7-83f2437d1fe6",
    "name": {
      "prefix": {
        "id": "d9079570-57f0-4530-b889-a07c95acb846",
        "name": {
          "enUS": "Mr."
        }
      },
      "first": "Oden",
      "middle": "Joe",
      "last": "Leonerd",
      "formerLast": "",
      "suffix": {
        "id": "99ace441-e900-4a4c-9731-c97ea8451482",
        "name": {
          "enUS": "III"
        }
      },
      "preferredFirst": "Kevin"
    },
    "email": "[email protected]",
    "description": "Oden is THE person who knows the product best. She loves helping new team members.",
    "externalUserId": "145A494C-DAFD-4454-881C-6700C85512C8"
  },
  "onboardingOwner": {
    "id": "2d42c7a5-52de-402e-92af-493b5b7f0682",
    "name": {
      "prefix": {
        "id": "d9079570-57f0-4530-b889-a07c95acb846",
        "name": {
          "enUS": "Mr."
        }
      },
      "first": "Jared",
      "middle": "Joseph",
      "last": "Nalin",
      "formerLast": "",
      "suffix": {
        "id": "99ace441-e900-4a4c-9731-c97ea8451482",
        "name": {
          "enUS": "III"
        }
      },
      "preferredFirst": "Jared"
    },
    "email": "[email protected]",
    "externalUserId": "74A3D0C8-FF2A-4EC9-9263-F515B000A0C5"
  },
  "onboardingStatus": "Launched",
  "sentToProcessHireDate": {
    "utcInstant": "2018-06-07T17:44:25.358Z",
    "offset": "-04:00:00"
  },
  "launchedOn": {
    "utcInstant": "2018-06-07T17:44:25.358Z",
    "offset": "-04:00:00"
  },
  "hireDate": "2018-06-23T00:00:00Z",
  "orientationDate": "2018-07-06T00:00:00Z",
  "startDate": "2018-06-30T00:00:00Z",
  "organizationLevels": [
    {
      "id": "b7a43db9-73c7-43d6-aaab-7b2bc20ed50f",
      "level": 1,
      "code": "PROD",
      "description": "Product division"
    },
    {
      "id": "8e4507db-330b-466d-8786-9f55da5f6c31",
      "level": 2,
      "code": "PR",
      "description": "Public relations"
    },
    {
      "id": "2bf4a848-2926-485f-aa47-4aa8db90921b",
      "level": 3,
      "code": "STAT",
      "description": "Stanton branch"
    },
    {
      "id": "3c792567-7494-4f84-91ae-73c797c714ef",
      "level": 4,
      "code": "SALES",
      "description": "Sales team"
    }
  ],
  "provisioning": {
    "provisioningItems": [
      {
        "id": "9977e393-3e7a-4044-a8f9-d8c3f6ef0de2",
        "name": "Corporate Credit Card",
        "recipient": "[email protected]",
        "selectedOption": {
          "id": "a4971b36-e8a3-43c8-b163-27c6d9dfbb98",
          "description": "Amax Card"
        },
        "comments": "Requires a platinum Amax Card"
      },
      {
        "id": "1f9c7b77-18b3-4ab7-b9cb-03790c0dc4bd",
        "name": "Network Account",
        "recipient": "[email protected]",
        "selectedOption": {
          "id": "3c792567-7494-4f84-91ae-73c797c714ef",
          "description": "Super Account"
        },
        "comments": "Highest clearance"
      },
      {
        "id": "add33aee-ebff-4d50-8f45-9d7ab820c053",
        "name": "Phone Type",
        "recipient": "[email protected]",
        "selectedOption": {
          "id": "05882bc4-7ae6-40b5-b1ee-2e56dd37bb49",
          "description": "Galaxy S5"
        },
        "comments": "Requires a black phone"
      }
    ],
    "summaryEmailRecipients": [
      "[email protected]",
      "[email protected]",
      "[email protected]"
    ]
  },
  "identityUserId": "05882bc4-7ae6-40b5-b1ee-2e56dd37bb49",
  "externalUserId": "b7a4fd34-73c7-43d6-aaab-7b2bc20ed50f",
  “employeeNumber”: "12338"
  "personalMessage": "Hugo, I was very impressed with your passion. I am looking forward to working with you and I know your expertise in this space will help our team get to the next level.",
  "pastStartDateReason": "An internal audit revealed that the new hire was not initiated",
  "id": "05882bc4-7ae6-40b5-b1ee-2e56dd37bb49",
  "createdAt": "2018-05-29T19:30:35.95Z",
  "updatedAt": "2018-06-07T17:44:25.378Z"
}