## TL;DR
Resolve the hire Box identity first, then invite. Check whether the email belongs to an existing managed user, an external collaborator, or a personal Box account, take the matching path, managed user creation, collaborator upgrade, or account invite to claim, and confirm the hire lands in the right onboarding folders with the right access level.

```text
Box enterprise provisioning failed: collaborator invite error during onboarding
```

## Use this when
- The Box provisioning or folder invite step errors for a hire whose email Box already knows.
- The hire collaborated on Box files as an external party before joining.
- Folder invites to other hires from the same job succeed.

## Not for this skill when
- The enterprise has no free managed seats. Handle Box seat capacity instead.
- Box sign-in fails for all managed users. Repair Box SSO configuration first.

## Steps
1. Search Box Admin Console Users and Groups and external collaboration reports for the hire email, classifying the existing state as managed user, external collaborator, or no record, and note any groups or folders already attached. Verify: the hire prior Box state is classified
2. If a managed user already exists, skip invite logic entirely and ensure the provisioning job links that user id, refreshes profile attributes, and adds the onboarding groups. If only an external collaborator exists, plan the conversion to a managed user so internal folder access follows employee policy. Verify: the job path matches the classified state
3. For a personal Box account on the corporate email, send the Box account claim or invite flow so the user joins the enterprise under management, warning the hire about the change in account ownership per company policy before triggering it. Verify: the claim invitation is sent and tracked
4. Complete the provisioning writes: create or convert the managed user, assign the onboarding groups, and add the user to the starter folders at the access level the role requires, typically editor on team folders and viewer on reference material. Verify: Box shows the managed user with the expected groups and folder access
5. Have the hire sign in through SSO, open a starter folder, and confirm they can create a test file where the role expects editing rights. Record the Box user id on the onboarding record. Verify: the hire works in Box with correct permissions
6. Update the provisioning job to classify before inviting for every hire, and sweep quarterly for external collaborators using corporate emails so conversions happen as a planned batch rather than failed invites. Verify: the job logs the classification branch per hire

## Why it happens
Box distinguishes sharply between managed users inside the enterprise, external collaborators invited to specific folders, and personal accounts that merely share an email. An invite written for a clean slate fails or misfires against all three prior states, each for a different reason. Onboarding inherits this complexity whenever hires arrive from partners, agencies, or prior contractor work where Box collaboration was common. Classifying the prior state and taking its specific path converts a confusing invite error into a routine identity decision the job can automate.

## Variants and edge cases
### Collaborator holds ownership of key folders
Transfer folder ownership to a managed owner before converting accounts, so access does not break for the wider team during onboarding.

### Enterprise forbids personal account claims
Some policies require the personal account email to be changed by the user first. Guide the hire through releasing the corporate email, then create the managed user.

### Group-based folder access missing after conversion
Converted users do not inherit group folders until group sync runs. Trigger the group membership sync and re-check folder visibility.

Compatibility: Applies to Box Enterprise and Business Plus accounts with admin console user management. Requires Box co-admin rights for user changes.

## Provenance

Resolved from the public thread: https://vectle.com/posts/pst_NwdnjVsUpzbqgmM4bDGEuA