Tracking Domain CallBack

Add Tracking Domain

Overview

Bulk API tracking domain configuration for campaign tracking.

Endpoint Details

HTTP Method	POST
Endpoint Path	/v2/settings/addTrackingDomain
API Version	Bulk API (v2.0)
Content-Type	application/json

Request Parameters

Parameter	Type	Required	Description	Example
owner_id	String	Yes	Your unique SendClean account identifier	user_12345
domain	String	Yes	Domain name to add/verify/check. Must be a domain you own and can modify DNS for	yourdomain.com

Request Example

Below is a complete example of the request body. Replace placeholder values with your actual credentials and data.

{
  "owner_id": "{USER_ID}",
  "domain": "track1.abc.com"
}

Response Format

Successful Response:

{
    "status": "success",
    "code": 200,
    "message": "Resource created successfully",
    "data": {
        "id": "resource_abc123",
        "created_at": "2026-04-17T10:30:00Z"
    }
}

Common Errors & Troubleshooting

401 - Unauthorized: Authentication credentials are missing or invalid

Solution: Verify owner_id and token are correct. Ensure they match your account credentials exactly with no extra whitespace.

500 - Internal server error: Unexpected server error occurred

Solution: Retry the request after a brief delay. If error persists, contact SendClean support with the request details and timestamp.

Implementation Examples

curl -X POST \
  https://api.sendclean.com/v2/settings/addTrackingDomain \
  -H 'Content-Type: application/json' \
  -d '{
  "owner_id": "{USER_ID}",
  "domain": "track1.abc.com"
}'

const axios = require('axios');

const url = 'https://api.sendclean.com/v2/settings/addTrackingDomain';

const payload = {
    "owner_id":"{USER_ID}",
    "domain":"track1.abc.com"
}  ;

axios.post(url, payload, {
    headers: {
        'Content-Type': 'application/json'
    }
})
.then(response => {
    console.log('Success:', response.data);
})
.catch(error => {
    console.error('Error:', error.response ? error.response.data : error.message);
});

<?php

$url = 'https://api.sendclean.com/v2/settings/addTrackingDomain';

$payload = json_decode('{
    "owner_id":"{USER_ID}",
    "domain":"track1.abc.com"
}  ', true);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode == 200) {
    $result = json_decode($response, true);
    print_r($result);
} else {
    echo "Error: $httpCode - $response";
}

?>

Check Tracking Domain

Overview

Bulk API DNS validation for tracking domains with detailed diagnostic information.

Endpoint Details

HTTP Method	POST
Endpoint Path	/v2/settings/checkTrackingDomain
API Version	Bulk API (v2.0)
Content-Type	application/json

Request Parameters

Parameter	Type	Required	Description	Example
owner_id	String	Yes	Your unique SendClean account identifier	user_12345
domain	String	Yes	Domain name to add/verify/check. Must be a domain you own and can modify DNS for	yourdomain.com

Request Example

Below is a complete example of the request body. Replace placeholder values with your actual credentials and data.

{
  "owner_id": "{USER_ID}",
  "domain": "track.abc.com"
}

Response Format

Successful Response:

{
    "status": "success",
    "code": 200,
    "message": "Operation completed successfully"
}

Common Errors & Troubleshooting

401 - Unauthorized: Authentication credentials are missing or invalid

Solution: Verify owner_id and token are correct. Ensure they match your account credentials exactly with no extra whitespace.

500 - Internal server error: Unexpected server error occurred

Solution: Retry the request after a brief delay. If error persists, contact SendClean support with the request details and timestamp.

Implementation Examples

curl -X POST \
  https://api.sendclean.com/v2/settings/checkTrackingDomain \
  -H 'Content-Type: application/json' \
  -d '{
  "owner_id": "{USER_ID}",
  "domain": "track.abc.com"
}'

const axios = require('axios');

const url = 'https://api.sendclean.com/v2/settings/checkTrackingDomain';

const payload = {
    "owner_id": "{USER_ID}",
    "domain": "track.abc.com"
};

axios.post(url, payload, {
    headers: {
        'Content-Type': 'application/json'
    }
})
.then(response => {
    console.log('Success:', response.data);
})
.catch(error => {
    console.error('Error:', error.response ? error.response.data : error.message);
});

<?php

$url = 'https://api.sendclean.com/v2/settings/checkTrackingDomain';

$payload = json_decode('{
    "owner_id": "{USER_ID}",
    "domain": "track.abc.com"
}', true);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode == 200) {
    $result = json_decode($response, true);
    print_r($result);
} else {
    echo "Error: $httpCode - $response";
}

?>

List Tracking Domain

Overview

Bulk API tracking domain listing with campaign-level tracking metrics.

Endpoint Details

HTTP Method	GET
Endpoint Path	/v2/settings/listTrackingDomain
API Version	Bulk API (v2.0)
Content-Type	application/json

Request Parameters

Parameter	Type	Required	Description	Example
owner_id	String	Yes	Your unique SendClean account identifier	user_12345
domain	String	Yes	Domain name to add/verify/check. Must be a domain you own and can modify DNS for	yourdomain.com

Response Format

Successful Response:

{
    "status": "success",
    "code": 200,
    "data": {
        "items": [
            {
                "id": "item_001",
                "created_at": "2026-04-01T09:00:00Z",
                "status": "active"
            }
        ],
        "total": 1,
        "page": 0
    }
}

Common Errors & Troubleshooting

401 - Unauthorized: Authentication credentials are missing or invalid

Solution: Verify owner_id and token are correct. Ensure they match your account credentials exactly with no extra whitespace.

500 - Internal server error: Unexpected server error occurred

Solution: Retry the request after a brief delay. If error persists, contact SendClean support with the request details and timestamp.

Delete Tracking Domain

Overview

Bulk API tracking domain removal with safety checks.

Endpoint Details

HTTP Method	DELETE
Endpoint Path	/v2/settings/deleteTrackingDomain
API Version	Bulk API (v2.0)
Content-Type	application/json

Request Parameters

Parameter	Type	Required	Description	Example
owner_id	String	Yes	Your unique SendClean account identifier	user_12345
domain	String	Yes	Domain name to add/verify/check. Must be a domain you own and can modify DNS for	yourdomain.com

Response Format

Successful Response:

{
    "status": "success",
    "code": 200,
    "message": "Resource deleted successfully"
}

Common Errors & Troubleshooting

401 - Unauthorized: Authentication credentials are missing or invalid

Solution: Verify owner_id and token are correct. Ensure they match your account credentials exactly with no extra whitespace.

500 - Internal server error: Unexpected server error occurred

Solution: Retry the request after a brief delay. If error persists, contact SendClean support with the request details and timestamp.