curl --request POST \
--url https://api.noyax.com/api/v1/definitions/currencies \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-CompanyID: <x-companyid>' \
--header 'X-UserID: <x-userid>' \
--data '
{
"Name": "TÜRK LİRASI",
"Code": "TRY",
"SubunitName": "KURUŞ",
"IsDefault": true
}
'using RestSharp;
var options = new RestClientOptions("https://api.noyax.com/api/v1/definitions/currencies");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("X-UserID", "<x-userid>");
request.AddHeader("X-CompanyID", "<x-companyid>");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"Name\": \"TÜRK LİRASI\",\n \"Code\": \"TRY\",\n \"SubunitName\": \"KURUŞ\",\n \"IsDefault\": true\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
const options = {
method: 'POST',
headers: {
'X-UserID': '<x-userid>',
'X-CompanyID': '<x-companyid>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({Name: 'TÜRK LİRASI', Code: 'TRY', SubunitName: 'KURUŞ', IsDefault: true})
};
fetch('https://api.noyax.com/api/v1/definitions/currencies', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.noyax.com/api/v1/definitions/currencies"
payload = {
"Name": "TÜRK LİRASI",
"Code": "TRY",
"SubunitName": "KURUŞ",
"IsDefault": True
}
headers = {
"X-UserID": "<x-userid>",
"X-CompanyID": "<x-companyid>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"Success": true,
"ResultCode": "0000",
"Data": {
"Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"Name": "TÜRK LİRASI",
"Code": "TRY",
"SubunitName": "KURUŞ",
"IsDefault": true
},
"Message": "<string>"
}{
"Success": false,
"ResultCode": "0543",
"Message": "Currency Code is required.",
"Errors": [
{
"Code": "0543",
"Message": "Currency Code is required."
}
]
}{
"Success": false,
"ResultCode": "0102",
"Message": "Token has expired. Obtain a new token using the refresh token.",
"Errors": [
{
"Code": "0102",
"Message": "Token has expired. Obtain a new token using the refresh token."
}
]
}{
"Success": false,
"ResultCode": "0110",
"Message": "You do not have permission for this operation.",
"Errors": [
{
"Code": "0110",
"Message": "You do not have permission for this operation."
}
]
}{
"Success": false,
"ResultCode": "0120",
"Message": "Daily request limit (10000) exceeded.",
"Errors": [
{
"Code": "0120",
"Message": "Daily request limit (10000) exceeded."
}
]
}Create currency
Adds a currency.
curl --request POST \
--url https://api.noyax.com/api/v1/definitions/currencies \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-CompanyID: <x-companyid>' \
--header 'X-UserID: <x-userid>' \
--data '
{
"Name": "TÜRK LİRASI",
"Code": "TRY",
"SubunitName": "KURUŞ",
"IsDefault": true
}
'using RestSharp;
var options = new RestClientOptions("https://api.noyax.com/api/v1/definitions/currencies");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("X-UserID", "<x-userid>");
request.AddHeader("X-CompanyID", "<x-companyid>");
request.AddHeader("Authorization", "Bearer <token>");
request.AddJsonBody("{\n \"Name\": \"TÜRK LİRASI\",\n \"Code\": \"TRY\",\n \"SubunitName\": \"KURUŞ\",\n \"IsDefault\": true\n}", false);
var response = await client.PostAsync(request);
Console.WriteLine("{0}", response.Content);
const options = {
method: 'POST',
headers: {
'X-UserID': '<x-userid>',
'X-CompanyID': '<x-companyid>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({Name: 'TÜRK LİRASI', Code: 'TRY', SubunitName: 'KURUŞ', IsDefault: true})
};
fetch('https://api.noyax.com/api/v1/definitions/currencies', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.noyax.com/api/v1/definitions/currencies"
payload = {
"Name": "TÜRK LİRASI",
"Code": "TRY",
"SubunitName": "KURUŞ",
"IsDefault": True
}
headers = {
"X-UserID": "<x-userid>",
"X-CompanyID": "<x-companyid>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text){
"Success": true,
"ResultCode": "0000",
"Data": {
"Id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"Name": "TÜRK LİRASI",
"Code": "TRY",
"SubunitName": "KURUŞ",
"IsDefault": true
},
"Message": "<string>"
}{
"Success": false,
"ResultCode": "0543",
"Message": "Currency Code is required.",
"Errors": [
{
"Code": "0543",
"Message": "Currency Code is required."
}
]
}{
"Success": false,
"ResultCode": "0102",
"Message": "Token has expired. Obtain a new token using the refresh token.",
"Errors": [
{
"Code": "0102",
"Message": "Token has expired. Obtain a new token using the refresh token."
}
]
}{
"Success": false,
"ResultCode": "0110",
"Message": "You do not have permission for this operation.",
"Errors": [
{
"Code": "0110",
"Message": "You do not have permission for this operation."
}
]
}{
"Success": false,
"ResultCode": "0120",
"Message": "Daily request limit (10000) exceeded.",
"Errors": [
{
"Code": "0120",
"Message": "Daily request limit (10000) exceeded."
}
]
}NameandCodeare required and must be unique within the company.Codeis at most 5 characters.SubunitNameis the name of the currency subunit (e.g.KURUŞ) and is optional.- If
IsDefaultistrue, the previous default currency loses the flag; a company has at most one default currency.
Authorizations
Access token obtained from the Noyax auth service with your API key.
Headers
ID of the Noyax user the request is made on behalf of. Written to the audit fields of created, updated and deleted records.
x >= 1ID of the company. The user must be assigned to this company. All reads and writes are limited to this company.
x >= 1ID of the accounting period. Optional for customer endpoints; if sent, it is written to created records.
x >= 1Body
Required. Currency name, unique within the company. At most 50 characters.
"TÜRK LİRASI"
Required. Short code of the currency, unique within the company. At most 5 characters.
"TRY"
Name of the currency subunit. At most 20 characters.
"KURUŞ"
Whether this is the company's default currency. Setting it to true removes the flag from the previous default currency.
true
Response
Created
Whether the operation succeeded.
true
"0000" on success. On failure, the code of the first error; all errors are listed in Errors.
"0000"
Show child attributes
Show child attributes
Error message when Success is false. Messages of all errors are joined into a single text.