Taxes
Verify and save a merchant Sovos account slot
Probes Sovos with the submitted credentials (stored values fill any omitted ones) and saves them only when Sovos authenticates them and the slot is still at expected_revision. The probe runs before the write and is never repeated. Never activates a slot; the first Sovos credentials for a company are refused here and are entered through the existing settings form. 404 while the tax-settings-credentials flag or the tax-sovos-account feature flag is off. Requires the companies.update permission.
PUT
/
api
/
settings
/
sovos_account
/
verified
Verify and save a merchant Sovos account slot
curl --request PUT \
--url https://api.fluid.app/api/settings/sovos_account/verified \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"sovos_account": {
"environment": "sandbox",
"expected_revision": [
12,
3
],
"hmac_key": "Scr4nton-Hmac-2026"
}
}
'import requests
url = "https://api.fluid.app/api/settings/sovos_account/verified"
payload = { "sovos_account": {
"environment": "sandbox",
"expected_revision": [12, 3],
"hmac_key": "Scr4nton-Hmac-2026"
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
sovos_account: {
environment: 'sandbox',
expected_revision: [12, 3],
hmac_key: 'Scr4nton-Hmac-2026'
}
})
};
fetch('https://api.fluid.app/api/settings/sovos_account/verified', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/settings/sovos_account/verified",
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([
'sovos_account' => [
'environment' => 'sandbox',
'expected_revision' => [
12,
3
],
'hmac_key' => 'Scr4nton-Hmac-2026'
]
]),
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;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/settings/sovos_account/verified"
payload := strings.NewReader("{\n \"sovos_account\": {\n \"environment\": \"sandbox\",\n \"expected_revision\": [\n 12,\n 3\n ],\n \"hmac_key\": \"Scr4nton-Hmac-2026\"\n }\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.fluid.app/api/settings/sovos_account/verified")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"sovos_account\": {\n \"environment\": \"sandbox\",\n \"expected_revision\": [\n 12,\n 3\n ],\n \"hmac_key\": \"Scr4nton-Hmac-2026\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/settings/sovos_account/verified")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"sovos_account\": {\n \"environment\": \"sandbox\",\n \"expected_revision\": [\n 12,\n 3\n ],\n \"hmac_key\": \"Scr4nton-Hmac-2026\"\n }\n}"
response = http.request(request)
puts response.read_body{
"sovos_account": {
"environment": "sandbox",
"username": "********",
"password": "********",
"hmac_key": "********",
"organization_code": "DUNDERMIFFLIN",
"active": false,
"readiness": {
"username": "set",
"password": "set",
"hmac_key": "set",
"organization_code": "set"
},
"revision": [
12,
4
]
},
"verification": {
"outcome": "credential_authenticated"
},
"audit": "recorded",
"status": 200,
"meta": {
"request_id": "c4f1b9e2-7a3d-4e8b-9f21-5d6a0b3e8c47",
"timestamp": "2026-09-14T15:32:08Z"
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}Authorizations
Bearer token authentication
Body
application/json
Body of the Sovos verified save and of the candidate Test Connection.
Show child attributes
Show child attributes
Response
Verified and saved, or already identical
One stored Sovos credential slot. The environment is the slot key; while any slots exist, exactly one is active. Storing a slot does not make Sovos selectable for quotes or filings.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
incomplete means the connection attempt event could not be recorded; the credentials were still saved.
Available options:
recorded, incomplete Available options:
200 Show child attributes
Show child attributes
⌘I
Verify and save a merchant Sovos account slot
curl --request PUT \
--url https://api.fluid.app/api/settings/sovos_account/verified \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"sovos_account": {
"environment": "sandbox",
"expected_revision": [
12,
3
],
"hmac_key": "Scr4nton-Hmac-2026"
}
}
'import requests
url = "https://api.fluid.app/api/settings/sovos_account/verified"
payload = { "sovos_account": {
"environment": "sandbox",
"expected_revision": [12, 3],
"hmac_key": "Scr4nton-Hmac-2026"
} }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.put(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PUT',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
sovos_account: {
environment: 'sandbox',
expected_revision: [12, 3],
hmac_key: 'Scr4nton-Hmac-2026'
}
})
};
fetch('https://api.fluid.app/api/settings/sovos_account/verified', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.fluid.app/api/settings/sovos_account/verified",
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([
'sovos_account' => [
'environment' => 'sandbox',
'expected_revision' => [
12,
3
],
'hmac_key' => 'Scr4nton-Hmac-2026'
]
]),
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;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fluid.app/api/settings/sovos_account/verified"
payload := strings.NewReader("{\n \"sovos_account\": {\n \"environment\": \"sandbox\",\n \"expected_revision\": [\n 12,\n 3\n ],\n \"hmac_key\": \"Scr4nton-Hmac-2026\"\n }\n}")
req, _ := http.NewRequest("PUT", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.put("https://api.fluid.app/api/settings/sovos_account/verified")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"sovos_account\": {\n \"environment\": \"sandbox\",\n \"expected_revision\": [\n 12,\n 3\n ],\n \"hmac_key\": \"Scr4nton-Hmac-2026\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fluid.app/api/settings/sovos_account/verified")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"sovos_account\": {\n \"environment\": \"sandbox\",\n \"expected_revision\": [\n 12,\n 3\n ],\n \"hmac_key\": \"Scr4nton-Hmac-2026\"\n }\n}"
response = http.request(request)
puts response.read_body{
"sovos_account": {
"environment": "sandbox",
"username": "********",
"password": "********",
"hmac_key": "********",
"organization_code": "DUNDERMIFFLIN",
"active": false,
"readiness": {
"username": "set",
"password": "set",
"hmac_key": "set",
"organization_code": "set"
},
"revision": [
12,
4
]
},
"verification": {
"outcome": "credential_authenticated"
},
"audit": "recorded",
"status": 200,
"meta": {
"request_id": "c4f1b9e2-7a3d-4e8b-9f21-5d6a0b3e8c47",
"timestamp": "2026-09-14T15:32:08Z"
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}{
"message": "<string>",
"error": "<string>",
"error_message": "<string>",
"errors": "<string>",
"meta": {
"request_id": "<string>",
"timestamp": "2023-11-07T05:31:56Z"
}
}