---
title: "Update user"
method: PUT
path: "/users/{id}"
tags: ["Users"]
---

# Update user

`PUT /users/{id}`

Update user by ID

## Path parameters

- `id` string, required

## Request body

- object
  - `email` string
  - `emails` string[]
  - `firstName` string
  - `lastName` string
  - `title` string
  - `timezone` string
  - `picture` object
    - `thumbnail` string, required
    - `regular` string, required
    - `large` string, required
  - `tags` string[]
  - `phone` string
  - `phones` string[]
  - `preferredContactMethod` string
  - `noteBeforeContacting` string
  - `notes` string
  - `favs` object
    - `views` string[], required
  - `displayLanguage` string
  - `settings` object
    - `notifications` object — Notification settings
      - `subscriptions` object[], required
        - `type` 'PAYMENT' | 'RESERVATION' | 'TASK' | 'GENERAL' | 'NIGHTS_LIMIT' | 'PROPERTY', required
        - `name` string, required
        - `targets` string[], required

## Response `200`

Success response

- object
  - `_id` string — User MongoDB _id
  - `accountId` string — Your account ID
  - `email` string
  - `emails` string[]
  - `firstName` string
  - `userStartedUpdateEmailFlow` boolean
  - `lastName` string
  - `fullName` string
  - `title` string
  - `timezone` string
  - `picture` object
    - `thumbnail` string, required
    - `regular` string, required
    - `large` string, required
  - `tags` string[]
  - `lastActivityTime` number
  - `phone` string
  - `phones` string[]
  - `preferredContactMethod` string
  - `noteBeforeContacting` string
  - `notes` string
  - `favs` object
    - `views` string[], required
  - `displayLanguage` string
  - `settings` object
    - `notifications` object — Notification settings
      - `subscriptions` object[], required
        - `type` 'PAYMENT' | 'RESERVATION' | 'TASK' | 'GENERAL' | 'NIGHTS_LIMIT' | 'PROPERTY', required
        - `name` string, required
        - `targets` string[], required
  - `roles` object[] — Deprecated: Roles field is optional and may not be present for users created in the new flow.
    - `roleId` string, required — Role ID: * `58db6932ea2a13ea9f4855a5` - Account manager * `578b52a6dddfe2b1d0781b0e` - Listing Viewer * `578b52a6dddfe2b1d0781b0f` - Calendar Availability Control * `578b52a6dddfe2b1d0781b12` - Listing Admin * `578b52a6dddfe2b1d0781b10` - Calendar Full Control * `578b52a6dddfe2b1d0781b11` - Listing's Financials * `57447a900ebc04ba98064035` - Account admin * `57c2d040cf6c3fed6a4d1775` - Integration Manager * `58db693fea2a13ea9f4855aa` - Viewer * `579e1769cf6c3fed6a3f6b1a` - Listing Manager * `5e567a850ba1fb0244146fc0` - Calendar Viewer * `5e57b0826b4440002a603a93` - Communication Agent * `60d1b0fb396b25993e756e63` - Revenue Manager
    - `listingIds` string[]

## Other responses

- `400` — Bad request

---

[API](https://skmtc.net/guesty/apis/guesty-open-api.md) · [All operations](https://skmtc.net/guesty/apis/guesty-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/guesty/guesty-open-api/versions/7c62644070f2/schema)