curl --request POST \
--url https://api.noyax.com/api/v1/customers/{customerId}/addresses \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-CompanyID: <x-companyid>' \
--header 'X-UserID: <x-userid>' \
--data '
{
"DistrictId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"Address": "Caferağa Mah. Moda Cad. No: 10",
"PostalCode": "34710",
"IsInvoiceAddress": true,
"CoordinateX": 40.9877,
"CoordinateY": 29.0254
}
'using RestSharp;
var options = new RestClientOptions("https://api.noyax.com/api/v1/customers/{customerId}/addresses");
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 \"DistrictId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"Address\": \"Caferağa Mah. Moda Cad. No: 10\",\n \"PostalCode\": \"34710\",\n \"IsInvoiceAddress\": true,\n \"CoordinateX\": 40.9877,\n \"CoordinateY\": 29.0254\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({
DistrictId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
Address: 'Caferağa Mah. Moda Cad. No: 10',
PostalCode: '34710',
IsInvoiceAddress: true,
CoordinateX: 40.9877,
CoordinateY: 29.0254
})
};
fetch('https://api.noyax.com/api/v1/customers/{customerId}/addresses', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.noyax.com/api/v1/customers/{customerId}/addresses"
payload = {
"DistrictId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"Address": "Caferağa Mah. Moda Cad. No: 10",
"PostalCode": "34710",
"IsInvoiceAddress": True,
"CoordinateX": 40.9877,
"CoordinateY": 29.0254
}
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",
"CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"DistrictId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"DistrictName": "Kadıköy",
"CityName": "İstanbul",
"CountryName": "Türkiye",
"Address": "Caferağa Mah. Moda Cad. No: 10",
"FullAddress": "<string>",
"PostalCode": "34710",
"IsInvoiceAddress": true,
"CoordinateX": 40.9877,
"CoordinateY": 29.0254
},
"Message": "<string>"
}{
"Success": false,
"ResultCode": "1102",
"Message": "DistrictId is required.",
"Errors": [
{
"Code": "1102",
"Message": "DistrictId 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": "1000",
"Message": "Customer not found.",
"Errors": [
{
"Code": "1000",
"Message": "Customer not found."
}
]
}{
"Success": false,
"ResultCode": "0120",
"Message": "Daily request limit (10000) exceeded.",
"Errors": [
{
"Code": "0120",
"Message": "Daily request limit (10000) exceeded."
}
]
}Create address
Adds a new address to a customer.
curl --request POST \
--url https://api.noyax.com/api/v1/customers/{customerId}/addresses \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-CompanyID: <x-companyid>' \
--header 'X-UserID: <x-userid>' \
--data '
{
"DistrictId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"Address": "Caferağa Mah. Moda Cad. No: 10",
"PostalCode": "34710",
"IsInvoiceAddress": true,
"CoordinateX": 40.9877,
"CoordinateY": 29.0254
}
'using RestSharp;
var options = new RestClientOptions("https://api.noyax.com/api/v1/customers/{customerId}/addresses");
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 \"DistrictId\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"Address\": \"Caferağa Mah. Moda Cad. No: 10\",\n \"PostalCode\": \"34710\",\n \"IsInvoiceAddress\": true,\n \"CoordinateX\": 40.9877,\n \"CoordinateY\": 29.0254\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({
DistrictId: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
Address: 'Caferağa Mah. Moda Cad. No: 10',
PostalCode: '34710',
IsInvoiceAddress: true,
CoordinateX: 40.9877,
CoordinateY: 29.0254
})
};
fetch('https://api.noyax.com/api/v1/customers/{customerId}/addresses', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.noyax.com/api/v1/customers/{customerId}/addresses"
payload = {
"DistrictId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"Address": "Caferağa Mah. Moda Cad. No: 10",
"PostalCode": "34710",
"IsInvoiceAddress": True,
"CoordinateX": 40.9877,
"CoordinateY": 29.0254
}
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",
"CustomerId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"DistrictId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"DistrictName": "Kadıköy",
"CityName": "İstanbul",
"CountryName": "Türkiye",
"Address": "Caferağa Mah. Moda Cad. No: 10",
"FullAddress": "<string>",
"PostalCode": "34710",
"IsInvoiceAddress": true,
"CoordinateX": 40.9877,
"CoordinateY": 29.0254
},
"Message": "<string>"
}{
"Success": false,
"ResultCode": "1102",
"Message": "DistrictId is required.",
"Errors": [
{
"Code": "1102",
"Message": "DistrictId 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": "1000",
"Message": "Customer not found.",
"Errors": [
{
"Code": "1000",
"Message": "Customer not found."
}
]
}{
"Success": false,
"ResultCode": "0120",
"Message": "Daily request limit (10000) exceeded.",
"Errors": [
{
"Code": "0120",
"Message": "Daily request limit (10000) exceeded."
}
]
}DistrictIdandAddressare required. City and country come from the district.- If
IsInvoiceAddressistrue, the previous invoice address loses the flag. - The first address of a customer always becomes the invoice address, regardless of the value sent.
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 >= 1Path Parameters
Customer ID.
Body
Required. ID of a district from GET /api/v1/definitions/districts. City and country come from the district.
Required. Street address.
"Caferağa Mah. Moda Cad. No: 10"
Postal code.
"34710"
Whether this is the invoice address. A customer always has exactly one invoice address.
true
Location coordinate X.
40.9877
Location coordinate Y.
29.0254
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.