---
title: "PUT /rh/accounts/{accountId}"
method: PUT
path: "/rh/accounts/{accountId}"
tags: ["Account"]
---

# PUT /rh/accounts/{accountId}

`PUT /rh/accounts/{accountId}`

## Request

- Base URL: `https://api.app.subskribe.com`
- URL: `https://api.app.subskribe.com/rh/accounts/{accountId}`
- Auth: API key in header `X-API-Key`

## Path parameters

- `accountId` string, required

## Request body

- NewAccountJson
  - `accountId` string, required: Account ID - Required for CPQ-RevenuHub integration (max 36 characters)
  - `name` string, required: Account name
  - `description` string: (optional) Account description
  - `crmId` string: (optional) CRM ID
  - `accountDisplayId` string: (optional) Human-readable account display ID generated by DealHub (e.g. ACC-100847). Immutable once set.
  - `currency` string: Currency code (ISO 4217 format). Optional - defaults to USD if not provided. Example: USD, EUR, GBP
  - `shippingAddress` AccountAddressJson
    - `streetAddressLine1` string: Address Line 1 of the Contact
    - `streetAddressLine2` string: Address Line 2 of the Contact
    - `streetAddressLine3` string: Address Line 3 of the Contact
    - `city` string: City of the Contact
    - `state` string: State Code of the Contact (ISO 3166-2 state/province code). Currently supported for USA, Canada. For instance, for Arizona (USA), set state as AZ (not US-AZ).For British Columbia (Canada), set as BC (not CA-BC)
    - `country` string: Country Code of the Contact ( ISO 3166 alpha-2 country code).
    - `zipcode` string: Zip or Postal Code of the Contact
  - `billingAddress` AccountAddressJson
    - `streetAddressLine1` string: Address Line 1 of the Contact
    - `streetAddressLine2` string: Address Line 2 of the Contact
    - `streetAddressLine3` string: Address Line 3 of the Contact
    - `city` string: City of the Contact
    - `state` string: State Code of the Contact (ISO 3166-2 state/province code). Currently supported for USA, Canada. For instance, for Arizona (USA), set state as AZ (not US-AZ).For British Columbia (Canada), set as BC (not CA-BC)
    - `country` string: Country Code of the Contact ( ISO 3166 alpha-2 country code).
    - `zipcode` string: Zip or Postal Code of the Contact
  - `uvcaCfacId` integer, required: uvca_cfac_id - Required for CPQ-RevenuHub integration
  - `entityIds` string[]: (optional) Entity IDs where this account belongs
  - `taxExemptionUseCode` 'A' | 'B' | 'C' | 'D' | 'E' | 'F' | 'G' | 'H' | 'I' | 'J' | 'K' | 'L' | 'M' | 'N' | 'P' | 'Q' | 'R': (optional) Tax exemption use code
  - `hasAutomaticPayment` boolean: (optional) Input true, if this Account will have an automatic payment. Default is false
  - `excludeFromBatchOperations` boolean: (optional) Input true, if this account needs to be excluded from Batch Operations. Default is false
  - `excludeFromDunning` boolean: (optional) Input true, if this account needs to be excluded from Dunning emails. Default is false
  - `supportedPaymentTypes` string[]: (optional) Supported payment types for this Account. Example: ACH, Card, Check, Wire, Invoice
  - `taxId` string: (optional) Tax identifier for the account (max 100 characters)
  - `attributes` object: (optional) Additional attributes as key-value pairs for CPQ integration
  - `updatedOn` integer: (optional) Last updated timestamp (epoch seconds)

## Response `default`

successful operation

---

[API](https://skmtc.dev/dealhub/apis/subskribe-api.md) - [All operations](https://skmtc.dev/dealhub/apis/subskribe-api/llms.txt) - [OpenAPI document](https://skmtc.dev/dealhub/apis/subskribe-api/revisions/c1ee531b82ce?raw)