# Upsert User

Upsert User

Endpoint: PATCH /rest/2.0/USER
Version: 1.0
Security: JWT

## Header parameters:

  - `sessionId` (string, required)

## Request fields (application/json; charset=utf-8):

  - `brmObjects` (object)

  - `brmObjects.RegionalSettings` (string)
    RegionalSettings

  - `brmObjects.Id` (string, required)
    Id: User id

  - `brmObjects.Created` (string)
    System controlled field: Date and time the record was created

  - `brmObjects.CreatedUserId` (string)
    System controlled field: Id of the user that created the record

  - `brmObjects.UpdatedUserId` (string)
    System controlled field: Id of the last user that updated the record

  - `brmObjects.Updated` (string)
    System controlled field: Date and time the record was last updated

  - `brmObjects.Username` (string)
    Username

  - `brmObjects.First_Name` (string)
    First_Name: First Name

  - `brmObjects.Last_Name` (string)
    Last_Name: Last Name

  - `brmObjects.Email` (string)
    Email

  - `brmObjects.Status` (string)
    Status

  - `brmObjects.FederationId` (string)
    FederationId

  - `brmObjects.RoleId` (integer, required)
    RoleId

  - `brmObjects.LanguageCode` (integer, required)
    LanguageCode

  - `brmObjects.ThemeId` (string)
    ThemeId: Theme

  - `brmObjects.TimeZoneId` (integer, required)
    TimeZoneId

  - `brmObjects.ConvertTimeZone` (integer)
    ConvertTimeZone

  - `brmObjects.ResetPasswordFlag` (integer)
    ResetPasswordFlag

  - `brmObjects.RoleName` (string)
    RoleName

  - `brmObjects.ForbidInternalAuth` (integer)
    ForbidInternalAuth: Forbid Internal Authentication

  - `brmObjects.City` (string)
    City

  - `brmObjects.Addr1` (string)
    Addr1: Address 1

  - `brmObjects.Addr2` (string)
    Addr2: Address 2

  - `brmObjects.BCC` (string)
    BCC

  - `brmObjects.CC` (string)
    CC

  - `brmObjects.CollectionsFlag` (string)
    CollectionsFlag

  - `brmObjects.Country` (string)
    Country

  - `brmObjects.Fax` (string)
    Fax

  - `brmObjects.HomePhone` (string)
    HomePhone

  - `brmObjects.MobilePhone` (string)
    MobilePhone

  - `brmObjects.Phone` (string)
    Phone

  - `brmObjects.RootAccountId` (string)
    RootAccountId

  - `brmObjects.ServicePointName` (string)
    ServicePointName

  - `brmObjects.State` (string)
    State

  - `brmObjects.Title` (string)
    Title

  - `brmObjects.Type` (string)
    Type

  - `brmObjects.User1` (string)
    User1

  - `brmObjects.User2` (string)
    User2

  - `brmObjects.UserGroupId` (string)
    UserGroupId

  - `brmObjects.Zip` (string)
    Zip

  - `brmObjects.InvoiceLabel` (string)
    InvoiceLabel

  - `brmObjects.UserTag` (string)
    UserTag

  - `brmObjects.AccountId` (integer)
    AccountId: Account

  - `brmObjects.RoleStatus` (string)
    RoleStatus

  - `brmObjects.ImmediateManager` (integer)
    ImmediateManager

  - `externalIDFieldName` (string)
    Enum: "Username"

## Response 200 fields (application/json):

  - `upsertResponse` (array)

  - `upsertResponse.Id` (integer)

  - `upsertResponse.success` (boolean)

  - `upsertResponse.ErrorText` (string)

  - `upsertResponse.ErrorElementField` (string)

  - `upsertResponse.created` (boolean)