Creates a new user connector to establish a relationship between a user and either the library or a specific outlet. If a user with the provided email doesn't exist, a new user account will be created automatically.

User Creation Behavior

This endpoint handles two scenarios:

User Doesn't Exist

If no user account exists with the provided email address, the endpoint will:

Create a new user account with the provided email, first_name, and last_name
Create a user connector linking the new user to the library or outlet
Optionally send a verification email if send_verification_email is set to true

User Already Exists

If a user account already exists with the provided email address, the endpoint will:

Use the existing user account
Create a user connector linking the existing user to the library or outlet
Update the user's first_name and last_name if provided (if they differ from existing values)

User Connector Types

The type of user connector is determined automatically based on the presence of the outlet field:

Library User (L): Created when outlet is not provided - grants access to the entire library
Outlet User (O): Created when outlet is provided - grants access to a specific outlet

Verification Email

When send_verification_email is set to true, the user will receive an email to verify their account and set up their password. This is particularly useful when creating new users.