---
title: "Add-TeamUser"
slug: "scripting-add-team-user"
updated: 2026-01-20T20:15:02Z
published: 2026-01-20T20:15:02Z
canonical: "help.agilityblue.com/scripting-add-team-user"
---

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

# Add-TeamUser

## Summary

Creates a new team user.

```powershell
Add-TeamUser
    -Entry
```

Returns the created team user object.

## Parameters

| Parameter | Type | Required? | Notes |
| --- | --- | --- | --- |
| Entry | Team User | Yes |  |

## Examples

### Add a user to a team

```powershell
# Create a team user object with required fields
$teamUser = @{
    TeamId = "34e89524-1052-4381-a19a-083a20de9514"
    UserId = "08077d23-bb13-4727-b76d-ab8fdf9d870f"
}

$teamUser = Add-TeamUser -Entry $teamUser

# Output some information to help indicate that the team user was created
Write-Output "Added user '$($teamUser.UserFullName)' to team '$($teamUser.TeamName)' (Id: #$($teamUser.TeamUserId))"

# For debug purposes, convert the data to output as JSON so we can see all the fields
Write-Output ""
Write-Output "JSON Results:"

$jsonOutput = $teamUser | ConvertTo-Json -Depth 10

# Output the data
Write-Output $jsonOutput
```

Execution results:

```json
Added user 'Max Miller' to team 'Processing' (Id: #10)

JSON Results:
{
  "TeamUserId": 10,
  "TeamId": "34e89524-1052-4381-a19a-083a20de9514",
  "UserId": "08077d23-bb13-4727-b76d-ab8fdf9d870f",
  "Team": null,
  "TeamName": "Processing",
  "User": null,
  "UserFullName": "Max Miller",
  "UserEmail": "mmiller@agilityblue.com",
  "UserActive": true,
  "CreatedByFullName": "Max Miller",
  "CreatedById": "510e109b-6ff5-4442-9670-cd5e3cd82a7a",
  "CreatedOn": "2026-01-20T20:13:48.6160196+00:00",
  "CreatedBy": null,
  "LastUpdatedByFullName": "Max Miller",
  "LastUpdatedById": "510e109b-6ff5-4442-9670-cd5e3cd82a7a",
  "LastUpdatedOn": "2026-01-20T20:13:48.6160196+00:00",
  "LastUpdatedBy": null
}
```