---
title: "POST /rh/accounts"
method: POST
path: "/rh/accounts"
tags: ["Account"]
---

# POST /rh/accounts

`POST /rh/accounts`

## 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.net/dealhub/apis/quote-api.md) · [All operations](https://skmtc.net/dealhub/apis/quote-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dealhub/quote-api/versions/c30f5b9fbfab/schema)