---
title: "Update a specific user"
description: "PUT /users/{user_id} — Each team member can edit their own details; admins can update anyone's. The API can edit these fields: first_name, last_name, company, and bcc_email."
canonical_url: https://developer.onepagecrm.com/api/reference/users/put-users-user_id/
source: Markdown mirror of https://developer.onepagecrm.com/api/reference/users/put-users-user_id/
---

`PUT /users/{user_id}`

Each team member can edit their own details; admins can update anyone's. The API can edit these fields: first_name, last_name, company, and bcc_email. Set bcc_email to true to generate a new BCC email address, otherwise omit it — you can only update bcc_email for yourself.

Resource: [Users](https://developer.onepagecrm.com/api/reference/users/) · [API Reference](https://developer.onepagecrm.com/api/reference/)

## Request

```bash
curl -X PUT "https://app.onepagecrm.com/api/v3/users/{user_id}" \
  -u $user_id:$api_key \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "Jane",
    "last_name": "Doe",
    "company_name": "Big Company Inc.",
    "bcc_email": "true"
  }'
```

Authentication is HTTP Basic — `user_id` as username, `api_key` as password.
See https://developer.onepagecrm.com/api/authentication/.

## Path parameters

| Name | Type | Description |
| --- | --- | --- |
| `user_id` | string | User ID |

## Request body

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `first_name` | string |  | First name of the user |
| `last_name` | string |  | Last name of the user |
| `company_name` | string |  | Name of the company that the user works for |
| `bcc_email` | string |  | Should the BCC email address be re-generated for this user (you can only update this field for yourself) |

## Responses

### 200

OK

```json
{
  "status": 0,
  "message": "OK",
  "timestamp": 1528373119,
  "data": {
    "user": {
      "id": "5aba31e99007ba0f570c12f7",
      "first_name": "Jane",
      "last_name": "Doe",
      "email": "jane.doe@example.com",
      "company_name": "Big Company Inc.",
      "account_rights": [
        "activity",
        "edit_target",
        "pipeline",
        "export",
        "private_contacts"
      ],
      "photo_url": "https://{foo.bar}/jane-doe.jpg",
      "country_code": "IE",
      "bcc_email": "5abg31e93007ba0f470c92q6@users.onepagecrm.com",
      "google_contacts_email": "jane.doe@example.com"
    }
  }
}
```

Standard error responses: 400, 401, 403, 404, 409, 500 — shared across the API. See https://developer.onepagecrm.com/api/errors/.

## Related guides

- [Authentication](https://developer.onepagecrm.com/api/authentication/)
- [Errors](https://developer.onepagecrm.com/api/errors/)
- [Rate limits](https://developer.onepagecrm.com/api/rate-limits/)
- [Partial updates](https://developer.onepagecrm.com/api/partial-updates/)