Create a synchronization request
curl --request POST \
--url https://thetradedesk.narrativeconnectors.com/taxonomies/synchronization-requests \
--header 'Authorization: Bearer <token>'import requests
url = "https://thetradedesk.narrativeconnectors.com/taxonomies/synchronization-requests"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://thetradedesk.narrativeconnectors.com/taxonomies/synchronization-requests', 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://thetradedesk.narrativeconnectors.com/taxonomies/synchronization-requests",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://thetradedesk.narrativeconnectors.com/taxonomies/synchronization-requests"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://thetradedesk.narrativeconnectors.com/taxonomies/synchronization-requests")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://thetradedesk.narrativeconnectors.com/taxonomies/synchronization-requests")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "5b9e2f64-1c7a-4d3e-8f02-6a4c9d1e7b35",
"company_id": 1634,
"created_at": "2026-10-21T14:10:00Z",
"jobs": {
"create_connections": {
"completed": 0,
"failed": 0,
"failures": [],
"in_progress": 0,
"pending": 1
},
"create_data_rate_batches": {
"completed": 0,
"failed": 0,
"failures": [],
"in_progress": 0,
"pending": 1
},
"create_taxonomy_elements": {
"completed": 0,
"failed": 0,
"failures": [],
"in_progress": 0,
"pending": 1
}
},
"status": "pending",
"updated_at": "2026-10-21T14:10:00Z"
}{
"error": "invalid_request",
"error_description": "TTD profile has no brand ID"
}{
"error": "forbidden",
"error_description": "Narrative API authentication error during GET /company-info/whoami"
}{
"error": "conflict",
"error_description": "Synchronization request 5b9e2f64-1c7a-4d3e-8f02-6a4c9d1e7b35 is already pending or in progress"
}{}{
"error": "upstream_error",
"error_description": "Narrative API server error (503) during GET /installations/whoami"
}taxonomies
Create a synchronization request
Sends draft and changed taxonomy elements to The Trade Desk. Returns 409 while another request is pending or in progress, and 400 if the profile has no brand id or there is nothing to synchronize.
POST
/
taxonomies
/
synchronization-requests
Create a synchronization request
curl --request POST \
--url https://thetradedesk.narrativeconnectors.com/taxonomies/synchronization-requests \
--header 'Authorization: Bearer <token>'import requests
url = "https://thetradedesk.narrativeconnectors.com/taxonomies/synchronization-requests"
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
fetch('https://thetradedesk.narrativeconnectors.com/taxonomies/synchronization-requests', 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://thetradedesk.narrativeconnectors.com/taxonomies/synchronization-requests",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://thetradedesk.narrativeconnectors.com/taxonomies/synchronization-requests"
req, _ := http.NewRequest("POST", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://thetradedesk.narrativeconnectors.com/taxonomies/synchronization-requests")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://thetradedesk.narrativeconnectors.com/taxonomies/synchronization-requests")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"id": "5b9e2f64-1c7a-4d3e-8f02-6a4c9d1e7b35",
"company_id": 1634,
"created_at": "2026-10-21T14:10:00Z",
"jobs": {
"create_connections": {
"completed": 0,
"failed": 0,
"failures": [],
"in_progress": 0,
"pending": 1
},
"create_data_rate_batches": {
"completed": 0,
"failed": 0,
"failures": [],
"in_progress": 0,
"pending": 1
},
"create_taxonomy_elements": {
"completed": 0,
"failed": 0,
"failures": [],
"in_progress": 0,
"pending": 1
}
},
"status": "pending",
"updated_at": "2026-10-21T14:10:00Z"
}{
"error": "invalid_request",
"error_description": "TTD profile has no brand ID"
}{
"error": "forbidden",
"error_description": "Narrative API authentication error during GET /company-info/whoami"
}{
"error": "conflict",
"error_description": "Synchronization request 5b9e2f64-1c7a-4d3e-8f02-6a4c9d1e7b35 is already pending or in progress"
}{}{
"error": "upstream_error",
"error_description": "Narrative API server error (503) during GET /installations/whoami"
}
