> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.travtus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Users

> The fields below are accepted via .csv file transfer to the USER folder. Upon receipt the file will be uploaded, creating or updating user records held within the Travtus platform.

Upload your file using the S3 key format `companyName_companyId/USER/filename.csv`, where `USER` is the `TYPE-SUBTYPE` folder value for user uploads. See [File Requirements & Validation](../file-requirements) for encoding, delimiter, and validation rules.

<ParamField path="email_address" body="email_address" type="string" required>
  The email address of the user.
</ParamField>

<ParamField path="first_name" type="string" required>
  The first name of the user
</ParamField>

<ParamField path="last_name" type="string" required>
  Enter a description
</ParamField>

<ParamField path="phone_number" type="string">
  Users phone number
</ParamField>

<ParamField path="job_title" type="string">
  Users job title
</ParamField>

<ParamField path="external_ref">
  Clients external reference UUID for the user
</ParamField>

<ParamField path="community_ids" type="string">
  List of the client external reference ids for the communities to be assigned to the user.

  Note the external reference ids must have been provided by the client and stored in the Travtus Platform.
</ParamField>

<ParamField path="reports_to" type="string">
  Name of line manager
</ParamField>

<ParamField path="send_welcome_email" type="bool" default="False">
  Set to True to send a welcome email when a user is created. By default, no email is sent
</ParamField>

<ParamField path="status" default="Active" type="string">
  User status, accepts values of "Active" or "Inactive".
</ParamField>

<ParamField path="roles" type="string" default="none">
  Defines the user’s role.
  Must exactly match a role created by the Admin in the Studio.
  Multiple roles can be assigned by providing a comma-separated list (e.g., "compass,gateway").
  Each role determines the permissions and restrictions for accessing features.
</ParamField>