Skip to main content
POST
Create city
  • CountryId is required and must be a country of the company.
  • Name is required and must be unique within the country.

Authorizations

Authorization
string
header
required

Access token obtained from the Noyax auth service with your API key.

Headers

X-UserID
integer<int32>
required

ID of the Noyax user the request is made on behalf of. Written to the audit fields of created, updated and deleted records.

Required range: x >= 1
X-CompanyID
integer<int32>
required

ID of the company. The user must be assigned to this company. All reads and writes are limited to this company.

Required range: x >= 1
X-PeriodID
integer<int32>

ID of the accounting period. Optional for customer endpoints; if sent, it is written to created records.

Required range: x >= 1

Body

CountryId
null | string<uuid>

Required. ID of a country from GET /api/v1/definitions/countries.

Name
null | string

Required. City name, unique within the country. At most 50 characters.

Example:

"ISTANBUL"

AreaCode
null | string

Telephone area code. At most 4 characters.

Example:

"216"

Response

Created

Success
boolean
required

Whether the operation succeeded.

Example:

true

ResultCode
string
required

"0000" on success. On failure, the code of the first error; all errors are listed in Errors.

Example:

"0000"

Data
object
required
Message
null | string

Error message when Success is false. Messages of all errors are joined into a single text.