curl --request POST \
--url https://management-api.fpjs.io/subdomains/{id}/domain-connect \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-API-Version: <x-api-version>' \
--data '{
"port": 8976
}'import requests
url = "https://management-api.fpjs.io/subdomains/{id}/domain-connect"
payload = { "port": 8976 }
headers = {
"X-API-Version": "<x-api-version>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-API-Version': '<x-api-version>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({port: 8976})
};
fetch('https://management-api.fpjs.io/subdomains/{id}/domain-connect', 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://management-api.fpjs.io/subdomains/{id}/domain-connect",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'port' => 8976
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"X-API-Version: <x-api-version>"
],
]);
$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://management-api.fpjs.io/subdomains/{id}/domain-connect"
payload := strings.NewReader("{\n \"port\": 8976\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Version", "<x-api-version>")
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.post("https://management-api.fpjs.io/subdomains/{id}/domain-connect")
.header("X-API-Version", "<x-api-version>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"port\": 8976\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://management-api.fpjs.io/subdomains/{id}/domain-connect")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Version"] = '<x-api-version>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"port\": 8976\n}"
response = http.request(request)
puts response.read_body{
"data": {
"domain_connect_url": "<string>",
"dns_provider": "Cloudflare"
}
}{
"error": {
"message": "<string>",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"code": "<string>",
"violations": [
{
"property": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"message": "<string>",
"code": "<string>"
}
}Create Domain Connect URL
Create a signed Domain Connect URL for the subdomain. With port, the URL redirects to a Fingerprint CLI loopback callback at http://127.0.0.1:{port}/domain-connect/callback, so the client must listen on that port before opening it; the URL is specific to that session and is not stored on the subdomain. Without port, the URL redirects to the subdomain page in the Fingerprint dashboard, which confirms the result. Open it in the user’s browser, then use the verify endpoint to check DNS and certificate progress.
curl --request POST \
--url https://management-api.fpjs.io/subdomains/{id}/domain-connect \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-API-Version: <x-api-version>' \
--data '{
"port": 8976
}'import requests
url = "https://management-api.fpjs.io/subdomains/{id}/domain-connect"
payload = { "port": 8976 }
headers = {
"X-API-Version": "<x-api-version>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'X-API-Version': '<x-api-version>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({port: 8976})
};
fetch('https://management-api.fpjs.io/subdomains/{id}/domain-connect', 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://management-api.fpjs.io/subdomains/{id}/domain-connect",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'port' => 8976
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json",
"X-API-Version: <x-api-version>"
],
]);
$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://management-api.fpjs.io/subdomains/{id}/domain-connect"
payload := strings.NewReader("{\n \"port\": 8976\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Version", "<x-api-version>")
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.post("https://management-api.fpjs.io/subdomains/{id}/domain-connect")
.header("X-API-Version", "<x-api-version>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"port\": 8976\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://management-api.fpjs.io/subdomains/{id}/domain-connect")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Version"] = '<x-api-version>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"port\": 8976\n}"
response = http.request(request)
puts response.read_body{
"data": {
"domain_connect_url": "<string>",
"dns_provider": "Cloudflare"
}
}{
"error": {
"message": "<string>",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"code": "<string>"
}
}{
"error": {
"message": "<string>",
"code": "<string>",
"violations": [
{
"property": "<string>",
"message": "<string>"
}
]
}
}{
"error": {
"message": "<string>",
"code": "<string>"
}
}port:
- With
port, the redirect targetshttp://127.0.0.1:{port}/domain-connect/callback. Start a local HTTP listener on that port before opening the URL and keep it running until authorization completes. Remote sessions require port forwarding so your browser can reach the listener. This is how the Fingerprint CLI uses it. - Without
port, the redirect targets the subdomain page in the Fingerprint dashboard, which confirms the result. Use this from clients that can’t listen on the user’s machine.
dns_provider display name is optional and may be omitted from the response.
This endpoint returns 409 if Domain Connect is unavailable for this subdomain or it is no longer awaiting DNS validation. A public pending status doesn’t guarantee availability: DNS may already be validated while certificate issuance is still in progress. If Domain Connect is unavailable, add the DNS records manually.
Authorization doesn’t mean the subdomain is ready to use. Call Verify subdomain, then poll Get subdomain (GET /subdomains/{id}) until the status is active before updating your application’s endpoints. Respect the verification rate limit.Authorizations
Body
Local loopback port where a CLI is listening for the Domain Connect callback. When omitted, the returned URL redirects to the subdomain page in the Fingerprint dashboard instead, which confirms the result; use this from clients that cannot listen on the user’s machine.
1 <= x <= 655358976
Was this page helpful?