---
title: "Customer.New"
method: POST
path: "/online/RivhitOnlineAPI.svc/Customer.New"
---

# Customer.New

`POST /online/RivhitOnlineAPI.svc/Customer.New`

## Request body

- object
  - `api_token` string, uuid, required — Rivhit Merchant API Identifier. **Format:** `UUID` **Default:** No
  - `last_name` string, required — Customer Last Name/Company Name. **Length:** 1 to 30 **Default:** Customer details
  - `first_name` string, nullable — Customer First Name. **Length:** 1 to 20 **Default:** Customer details
  - `address` string, nullable — Customers Address. **Length:** 1 to 30 **Default:** Customer details
  - `city` string, nullable — Customer's city. **Length:** 1 to 20 **Default:** Customer details
  - `pob` integer, nullable — Customers Postal Code. **Range:** 0 to 9999999 **Default:** Customer details
  - `zipcode` integer, nullable — Customers Zipcode. **Range:** 0 to 9999999 **Default:** Customer details
  - `phone` string, nullable — Customer Phone Number. **Length:** 1 to 15 **Default:** Customer details
  - `phone2` string, nullable — Customer Second Phone Number. **Length:** 1 to 15 **Default:** Customer details
  - `fax` string, nullable — Customer Fax Number. **Length:** 1 to 15 **Default:** Customer details
  - `email` string, email, nullable — Customer Email Address. **Length:** 6 to 50 **Default:** Customer details
  - `id_number` integer, nullable — Customer Israeli Id (by Custom Format). **Range:** 8-9 digits **Default:** No
  - `vat_number` integer, nullable — Customer Israeli Vat Number(by Custom Format). **Range:** 8-9 digits **Default:** No
  - `agent_id` integer, nullable — Agent Id Serial Number (Rivhit system). **Range:** 0 to 999999999 **Default:** Customer settings
  - `project_id` integer, nullable — Project Id Serial Number (Rivhit system). **Range:** 0 to 999999999 **Default:** No
  - `paying_customer_id` integer — Defined a Paying Custommer by Id. **Range:** 0 to 999999999 **Default:** No
  - `price_list_id` integer — Customer Price List. **Range:** 0 to 999 **Default:** Price list settings
  - `comments` string, nullable — Additional Comments About the Customer. **Length:** 1 to 400 **Default:** Customer settings
  - `customer_type` 1 | 20 | 60, nullable — Type of the Customer - to Create. **Options:** (1 = Customers 20 = Suppliers 60 = Agents) **Default:** Rivhit settings (usually 1)
  - `pal_code` 6 | 30, nullable — Customer Balance Sheet Type. **Options:** (6 = Customers 30 = Suppliers) **Default:** Rivhit settings (usually 6)
  - `acc_ref` string, nullable — Customer Third Party System Identifier. **Length:** 1 to 20 **Default:** Customer details
  - `country` string — Customer Country. **Length:** 1 to 39 **Default:** Customer details
  - `state` string — Customer State. **Length:** 1 to 10 **Default:** No
  - `foreign_zipcode` string, nullable — Customer Foreign Zip Code. **Length:** 1 to 7 **Default:** No
  - `currency_id` integer, nullable — Document Currency Type. **Options:** (1 = NIS 2 = USD 3 = EURO 4 = GBP 5 = AUD 6 = CAD 7 = CHF 8 = SEK 9 = DKK 10 = NOK) **Default:** Rivhit settings
  - `exempt_vat` boolean, nullable — Set if Customer is Exempt. **Default:** Not exempt
  - `credit_terms` 1 | 2 | 3, nullable — Customer Credit Terms. ~ Combine Net EOM/Net with value "credit_days" **Options:** (1 = Cash 2 = Net EOM 3 = Net) **Default:** No
  - `credit_days` integer, nullable — Customer Credit Days. **Range:** 1-100 **Default:** Rivhit settings
  - `discount_percent` number, double — Discount value. **Range:** 0 to 999999999.99 **Default:** No
  - `cust_id` integer — Set a specific Customer Identifier. ~ Only an available customer number **Range:** 0 to 999999999 **Default:** next available number
  - `request_reference` string, nullable — The Customer creation Request Reference. ~ Use for future search with method - Status.LastRequest ~ Should be unique value **Length:** 2GB **Default:** No

## Response `200`

Success - Customer Created.

- object
  - `error_code` integer — The Response Error/Status Number (0 = Success)
  - `client_message` string — The Client Error Message.
  - `debug_message` string — The Response Error Message.
  - `data` object
    - `customer_id` integer — Customer Identifier.

## Other responses

- `400` — Request Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/rivhit/apis/get-payment-url-22-12.md) · [All operations](https://skmtc.net/rivhit/apis/get-payment-url-22-12/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rivhit/get-payment-url-22-12/versions/ed5261a52458/schema)