ZenotiHelp

Onboard an employee through the web app

ZTZenoti Docs Team Updated October 27, 2026 8 min readGuide

Complete employee onboarding for Zenoti Integrated Payroll (ZIP) through the admin web app β€” personal details, bank account setup, and tax withholdings. This article is for administrators entering data on behalf of an employee. If you are an employee completing your own onboarding, use the myZen app onboarding flow instead.

Note: This article covers the admin-initiated web app flow. For the employee self-service flow through the MyZen app, see Onboard an employee through the MyZen app. Both flows write to the same payroll record and either can complete a partial onboarding started on the other.

Audience: Payroll administrators onboarding employees through the Zenoti web app on behalf of an employee.


On this page


Before you begin

Permission: Configure Payroll Payouts under Administrator > Payments β€” Required to onboard employees through the web app.

  • The business must be onboarded to ZIP with implementation status Ready to run.
  • The employee record must exist in Zenoti with the correct center assignment and employment type already set. ZIP onboarding adds payroll data to an existing employee record; it does not create the record itself.
  • You will need the employee's documents in hand before starting (see What you'll need).
  • ZIP is enabled for your tenant by Zenoti's implementation team after you enroll. If ZIP is not yet enabled for your organization, contact support@zenoti.com with your business name and FEIN in the subject line.

When to use the web app vs the MyZen app

Both surfaces write to the same Zenoti payroll record. Either surface can complete a partial onboarding started on the other.

Aspect Web app (this article) MyZen app
Who enters the data Administrator on behalf of the employee Employee self-service
Permission needed Configure Payroll Payouts None β€” employee authenticates as themselves
Best for Employees unable or unwilling to self-onboard; troubleshooting an existing onboarding; admin needs to enter multiple employees sequentially Standard onboarding; employee prefers entering their own data; data-privacy preference (employee enters their SSN directly into the app)
Field set Identical Identical
Tax form delivery Admin attaches; employee signs through their MyZen app after entry Employee signs in the same flow

For a business onboarding several employees at once, the fastest path is usually to invite each employee to self-onboard through MyZen in parallel rather than have an admin enter every record sequentially through the web app.

What you'll need

Collect these from each employee before starting:

  • Social Security Number (SSN). 9 digits, xxx-xx-xxxx. For business-classified Contractors, a business EIN may substitute.
  • Government-issued photo ID (Regular employees only β€” for I-9 employment-eligibility verification).
  • U.S. residential billing address; shipping address only if different from billing.
  • Bank routing number and account number for direct deposit.
  • Confirmation that the employee record exists in Zenoti with the correct center and employment type (Regular or Contractor).

Steps

Personal details

  1. Go to Employee > Zenoti Integrated Payroll.
  2. Open the Employees section from the right-side menu.
  3. Locate the employee and click Setup.
  4. In the Personal details section, verify or enter the following required fields:
    • Legal first name and legal last name β€” these fields are non-editable after the record is created. Verify them carefully before saving.
    • Date of birth
    • SSN or ITIN
    • Billing address (street, city, state, ZIP)
    • Shipping address (street, city, state, ZIP) β€” check the option to use the same address as billing if applicable
    • Phone number
    • Email address
  5. Click Sign and Submit to save this section.

Important: Employment type cannot be changed after the first payroll is processed. If a type change is required after the first payroll run, create a new employee profile. For details, see Employment type change after payroll run.

Bank account

  1. In the Bank account section, add the employee's checking or savings account. Choose a verification method:
    • Instant verification β€” Links the account through Plaid. Completes in seconds for supported banks. The employee may need to provide their online banking credentials during this step.
    • Manual verification β€” Microdeposits are sent to the account and arrive in 1–4 business days. Once received, the employee or admin enters the deposit amounts to complete verification.
  2. After saving, only the last 4 digits of the account number are displayed. The routing number and full account number are not shown again after the initial save.
  3. Click Sign and Submit to save this section.

Note: Each employee has one primary bank account for direct deposit. Net pay split configuration β€” routing portions of pay to secondary accounts β€” is managed separately. See Net pay splits.

Tax withholdings

  1. In the Tax withholdings section, complete the appropriate tax form based on the employee's employment type:
    • Regular employees β€” Complete the W-4 (federal tax withholding) and any applicable state withholding forms.
    • Contractors β€” Complete the W-9. Contractors classified as a business entity may use a business EIN in place of an SSN.
  2. Federal and state withholding fields are presented in sequence. Complete all required fields for the employee's work state.
  3. Click Sign and Submit to save this section.

Worked example: A Regular employee named Jordan Lee works at a center in Texas. Because Texas has no state income tax, only the federal W-4 form is presented. Jordan claims Single filing status, no additional withholding, and no dependents. The admin completes these fields and clicks Sign and Submit. Jordan receives a notification in MyZen to review and countersign the form.

Delivery preferences

  1. In the Delivery preferences section, set how the employee receives their tax documents and paystubs:
    • W-2/1099 form delivery preference β€” Select electronic delivery, paper mail, or both.
    • Notification settings β€” Configure whether the employee receives payroll-related notifications by email, in-app, or both.
  2. Click Sign and Submit to save this section.
  3. When all sections are complete, the employee's status updates to show onboarding is finished. They are included in the next scheduled payroll run.

Work-from-home employees

If an employee works remotely from a state different from their center's state, configure the work-from-home tax setting so that taxes are calculated based on the employee's home address rather than the center address.

  1. Go to Employee > Zenoti Integrated Payroll > Employee.
  2. Locate the employee and open View details.
  3. Select the Personal Details tab.
  4. Set Is Work From Home Employee to Yes.
  5. Save the record.

When this setting is enabled, ZIP calculates state and local taxes based on the employee's residential address on file, not the center's address.

Tips

  • Complete sections in order. Personal details must be saved before the bank account and tax sections unlock for editing.
  • Save after each section. Partial progress is preserved per section as long as you clicked Sign and Submit before navigating away. A session timeout before saving loses only the unsaved section.
  • Invite employees to self-onboard through MyZen for sensitive fields. Administrators can enter most fields on behalf of employees, but employees may prefer to enter their own SSN. Either surface completes the same record β€” start the record in the web app, then ask the employee to complete the SSN and bank fields in MyZen.
  • Instant bank verification is faster but requires online banking credentials. If the employee's bank is not supported by Plaid, use manual verification with microdeposits instead.
  • Check the center assignment before onboarding. If the employee is assigned to the wrong center in Zenoti, their taxes may be calculated against the wrong state or locality. Correct the center assignment in the employee record before completing ZIP onboarding.

Troubleshooting

Symptom Likely cause Action
SSN format invalid SSN entered without the xxx-xx-xxxx format, or contains non-numeric characters. Re-enter as 9 digits in xxx-xx-xxxx format. The web form auto-formats as you type.
Address validation fails Address doesn't match USPS records. Often a typo in street name, apartment number, or ZIP. Re-check against USPS Address Verification. Apartment or suite numbers go in the second line, not the main street field.
Employee record not in Zenoti The employee was never created in Zenoti, or has no center assignment. Create the employee record in Zenoti, assign a center, set employment type, then return to the ZIP Employees list and click Setup.
Setup button disabled Employee status is already complete, or the employee is locked because a first payroll has already been processed. Employment type change after first payroll requires a new profile. Open the employee detail to see status. If onboarding is complete, edit individual sections. If locked post-payroll, follow the new-profile flow in Employment type change after payroll run.
Page times out or session expired Long session without action. Sign in again. Partial progress is preserved per section as long as you clicked Sign and Submit before the timeout.
Tax withholding form shows unexpected state fields Employee's home address is in a different state than expected, or the work-from-home setting is enabled. Verify the billing address and the Is Work From Home Employee setting. See Work-from-home employees above.

Field-level validation error messages β€” for example, specific routing-number checksum failures or state-specific W-4 supplement fields β€” come from Check Technologies. Contact support@zenoti.com with your business name and FEIN if you encounter a validation error you cannot resolve.

Edge cases

  • Dependents on the W-4. Federal dependents are entered by the employee or admin in the tax-withholding section. The withholding calculation based on dependent entries is performed by Check Technologies.
  • Mid-onboarding address change. If the employee moves during the onboarding flow, edit the personal details section and save again. The updated address syncs to Check Technologies on save. You may need to re-verify the bank account if the bank's address on file differs from the new address.
  • Multi-state employees. ZIP records one home state per employee in the address fields. Cross-state withholding calculation β€” when an employee lives in one state and works in another, or splits time across states β€” is handled by Check Technologies. Contact support@zenoti.com with your business name and FEIN for guidance on multi-state withholding scenarios.
  • Mid-cycle hire. If you onboard an employee whose start date falls within an open pay period, they are included in the in-flight payroll run if the start date falls on or before the pay-period end date. Otherwise they start in the next cycle. First-paycheck proration is performed by Check Technologies.
  • Contractor with a business EIN. When the employment type is Contractor and the contractor is classified as a business entity, a business EIN may be entered in place of an SSN in the W-9 section. The I-9 employment-eligibility verification step does not apply to Contractors.
Was this article helpful?
Your feedback helps us improve our documentation.