Add

[POST] .../v1/country/add

Creates a new country reference record. Use this method to create a country reference record before using it in partner, firm, address or integration data. It creates one country and returns new_id after validating required name, fullname, code, alfa2 and alfa3 fields. The caller must have country add permission; missing body, missing required fields, denied access, duplicate or storage validation failures and persistent errors are returned as HTTP 200 ErrorResult business errors.

Request Parameters

Name Type Required Description
alfa2 String Required Two-character country code, usually ISO 3166-1 alpha-2.
alfa3 String Required Three-character country code, usually ISO 3166-1 alpha-3.
code String Required Three-digit country code.
fullname String Required Full country name.
name String Required Country name.

Request Example

{
  "name": "Uzbekistan",
  "fullname": "Republic of Uzbekistan",
  "code": "860",
  "alfa2": "UZ",
  "alfa3": "UZB"
}

Response Parameters

Name Type Description
ok Boolean Indicates whether the request completed successfully.
result Insert Created record result.

Response Example

{
  "ok": true,
  "result": {
    "new_id": 860
  }
}