---
title: "Update cPanel account"
method: GET
path: "/modifyacct"
tags: ["Accounts", "Account Management"]
---

# Update cPanel account

`GET /modifyacct`

This function modifies a cPanel account.

**Warning:**

We **strongly** recommend that you **do not** modify a single cPanel account's settings if that cPanel account uses a hosting plan (package). If the package values change, **the system will overwrite any of your custom values with the package's new values**.

**Note:**

On servers that run CentOS 7, you may see a `named` warning about the absence of SPF resource records on DNS.
  * This warning is **not** relevant on CentOS 7 servers, because [RFC 7208 deprecated SPF records](https://tools.ietf.org/html/rfc7208). CentOS 7 servers use TXT records instead of SPF records.
  * Red Hat 7.1 and CentOS 7.1 both contain `bind-9.9.4-23.el7`, which is an updated version of BIND that complies with RFC 7208. To resolve this issue, update your operating system to a version that contains the updated version of BIND. For more information, read the [Red Hat Bugzilla case about SPF record errors](https://bugzilla.redhat.com/show_bug.cgi?id=1215164).

## Query parameters

- `user` string, username, required
- `account_enhancements` string
- `BACKUP` 0 | 1
- `BWLIMIT` union
  - 'unlimited'
  - integer
- `contactemail` string, email
- `DBOWNER` string
- `DISK_BLOCK_LIMIT` integer
- `DNS` string, domain
- `domain` string, domain
- `HASCGI` 0 | 1
- `HASDKIM` 0 | 1
- `HASDMARC` 0 | 1
- `HASSHELL` 0 | 1
- `HASSPF` 0 | 1
- `LANG` string
- `LOCALE` string, ISO-3166-1 (alpha-2)
- `mail_node_alias` union
  - string — A mail node alias.
  - '.local' — Transfer a user’s mail from an existing mail node to the local server.
- `MAILBOX_FORMAT` 'maildir' | 'mbox'
- `MAX_DEFER_FAIL_PERCENTAGE` union
  - 'unlimited'
  - integer
- `MAX_EMAIL_PER_HOUR` union
  - 'unlimited'
  - integer
- `MAX_EMAILACCT_QUOTA` union
  - 'unlimited'
  - integer
- `max_team_users` integer
- `MAXADDON` union
  - 'unlimited'
  - integer
- `MAXFTP` union
  - 'unlimited'
  - integer
- `MAXLST` union
  - 'unlimited'
  - integer
- `MAXPARK` union
  - 'unlimited'
  - integer
- `MAXPASSENGERAPPS` union
  - 'unlimited'
  - integer
- `MAXPOP` union
  - 'unlimited'
  - integer
- `MAXSQL` union
  - 'unlimited'
  - integer
- `MAXSUB` union
  - 'unlimited'
  - integer
- `modify_firewall` 0 | 1
- `MXCHECK-*` integer
- `newuser` string, username
- `notify_account_authn_link` 0 | 1
- `notify_account_authn_link_notification_disabled` 0 | 1
- `notify_autossl_expiry` 0 | 1
- `notify_autossl_expiry_coverage` 0 | 1
- `notify_autossl_renewal` 0 | 1
- `notify_autossl_renewal_coverage` 0 | 1
- `notify_contact_address_change` 0 | 1
- `notify_contact_address_change_notification_disabled` 0 | 1
- `notify_disk_limit` 0 | 1
- `notify_password_change` 0 | 1
- `notify_password_change_notification_disabled` 0 | 1
- `notify_ssl_expiry` 0 | 1
- `OUTGOING_EMAIL_SUSPENDED` 0 | 1
- `owner` string, username
- `PUSHBULLET_ACCESS_TOKEN` string
- `QUOTA` union
  - 'unlimited'
  - integer
- `remove_missing_extensions` string
- `rename_database_objects` 0 | 1
- `reseller` 0 | 1
- `RS` string
- `shell` string, path
- `spamassassin` 0 | 1
- `STARTDATE` integer
- `STYLE` string
- `update_existing_email_account_quotas` 0 | 1

## Response `200`

HTTP Request was successful.

- object
  - `data` object
    - `cpuser` object — An object that contains the cPanel account's modified information. **Note:** * The possible properties in this section are the same as the possible query parameters (the attributes of the cPanel account). * These properties show up even if the query did **not** modify them. * Some of these properties **only** appear under certain other conditions. * If the cPanel account or its hosting plan use package extensions, the `cpuser` object will also include the extension's variables.
    - `domain` string, domain — The cPanel account's main domain.
    - `setshell` string, path — The absolute path to the cPanel account's shell.
    - `user` string, username — The cPanel account username. **Note:** If you changed the cPanel account's username, the function returns the new value.
  - `metadata` object
    - `command` string — The method name called.
    - `output` object — Output of the operation.
      - `messages` string[] — Any messages that the system generated.
      - `warnings` string[] — Any warnings that the system generated.
    - `reason` string — The reason the API function failed when the `metadata.result` field is `0`. This field may display a success message when a function succeeds.
    - `result` 0 | 1 — * `1` — Success. * `0` — Failed. Check the `reason` field for more details.
    - `version` integer — The version of the API function.

---

[API](https://skmtc.net/cpanel/apis/whm-api.md) · [All operations](https://skmtc.net/cpanel/apis/whm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cpanel/whm-api/revisions/3da41671c02c/schema)