v1

latestOpenAPI 3.1.02026-07-26294215839.4 KB
Onboarding
Public API

Create new hire packet

Creates a new hire packet instance (draft) for an employee. Company configuration is applied for default inclusion flags.

OAuth Scopes: onboarding.write

post/api/v1/new-hire-packets

Request body

contactEmployeeIdinteger nullable

Contact employee for the packet, if any.

requiresPersonalInformationboolean

Whether personal information collection is required.

requiresPhotoboolean

Whether a photo is required.

requiresPersonalQuestionsboolean

Whether personal questions are required.

arriveByTimestring nullable

Expected arrival time (time portion).

locationstring nullable

Work location label for the new hire.

sendGetToKnowYouEmailboolean

Whether to send the Get To Know You email.

showPayrollStateboolean

Whether to show state payroll fields.

showPayrollFederalboolean

Whether to show federal payroll fields.

showPayrollDirectDepositboolean

Whether to show direct deposit payroll fields.

nhpTemplateIdinteger nullable

Linked new hire packet template id, if any.

employeeIdinteger required

Employee to attach the new packet to.

Response

Created

idinteger nullable

Primary key of the new hire packet instance.

employeeIdinteger

Employee this packet belongs to.

contactEmployeeIdinteger nullable

Contact employee for the packet, if any.

requiresPersonalInformationboolean
requiresPhotoboolean
requiresPersonalQuestionsboolean
arriveByTimestring nullable

Expected arrival time (time portion).

locationstring nullable

Work location label for the new hire.

sentDatetimestring nullable

When the packet was sent (datetime string).

viewedDatetimestring nullable

When the packet was first viewed (datetime string).

completedDatetimestring nullable

When the packet was completed (datetime string).

createdByUserIdinteger nullable
createdDatetimestring nullable

When the packet row was created (datetime string).

sendGetToKnowYouEmailboolean
getToKnowYouEmailSentboolean nullable
showPayrollStateboolean nullable
showPayrollFederalboolean nullable
showPayrollDirectDepositboolean nullable
nhpConfigurationIdinteger nullable

Linked new hire packet configuration id, if any.

nhpTemplateIdinteger nullable
countNhpGtkySentinteger nullable
cancelledboolean
includePhotoOptionboolean

Whether photo collection is offered based on configuration.

status'cancelled' | 'completed' | 'sent' | 'draft'

Derived lifecycle status for the instance.