Replace buyer settings
curl --request PUT \
--url https://api.tilta.io/v1/buyers/{external_id}/settings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://api.tilta.io/v1/buyers/{external_id}/settings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.tilta.io/v1/buyers/{external_id}/settings"
payload = {}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tilta.io/v1/buyers/{external_id}/settings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"language": "AR",
"formality": "NEUTRAL"
}{
"code": "BAD_REQUEST",
"error": "Request validation failed. 1 issue found.",
"issues": [
{
"code": "INVALID_TYPE",
"path": "body.registered_at",
"message": "Invalid type"
}
]
}{
"error": "Unauthorized",
"code": "UNAUTHORIZED"
}Buyers
Replace buyer settings
Replace a buyer’s communication preferences. Set the language and formality Tilta uses for the automated emails it sends on your behalf.
PUT
/
v1
/
buyers
/
{external_id}
/
settings
Replace buyer settings
curl --request PUT \
--url https://api.tilta.io/v1/buyers/{external_id}/settings \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{}'const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({})
};
fetch('https://api.tilta.io/v1/buyers/{external_id}/settings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.tilta.io/v1/buyers/{external_id}/settings"
payload = {}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.tilta.io/v1/buyers/{external_id}/settings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "PUT",
CURLOPT_POSTFIELDS => json_encode([
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"language": "AR",
"formality": "NEUTRAL"
}{
"code": "BAD_REQUEST",
"error": "Request validation failed. 1 issue found.",
"issues": [
{
"code": "INVALID_TYPE",
"path": "body.registered_at",
"message": "Invalid type"
}
]
}{
"error": "Unauthorized",
"code": "UNAUTHORIZED"
}Use this endpoint to set the language and formality level Tilta applies to every automated email it sends to a buyer.
Match the language to the buyer’s
business_address_country so that onboarding invitations and payment reminders arrive in
the language the buyer’s finance team works in. FORMAL is the appropriate formality for most B2B communication.Authorizations
Your Tilta API key, sent as Bearer <key>.
Path Parameters
Unique identifier of a buyer.
Maximum string length:
100Pattern:
^[a-zA-Z0-9-_]+$Body
application/json
Buyer's preferred communication language. Send null to clear.
Available options:
AR, BG, CS, DA, DE, EL, EN, ES, ET, FI, FR, GA, HR, HU, IT, JA, LT, LV, MT, NL, NO, PL, PT, RO, RU, SK, SL, SV, TR, UK, ZH Buyer's preferred communication formality. Send null to clear.
Available options:
NEUTRAL, FORMAL, INFORMAL Response
Buyer's communication preferences.
Buyer's preferred communication language. Send null to clear.
Available options:
AR, BG, CS, DA, DE, EL, EN, ES, ET, FI, FR, GA, HR, HU, IT, JA, LT, LV, MT, NL, NO, PL, PT, RO, RU, SK, SL, SV, TR, UK, ZH Buyer's preferred communication formality. Send null to clear.
Available options:
NEUTRAL, FORMAL, INFORMAL