Create or Update Project

curl --request POST \
  --url https://www.dncscrub.com/app/main/rpc/project \
  --header 'loginId: <loginid>'

const options = {method: 'POST', headers: {loginId: '<loginid>'}};

fetch('https://www.dncscrub.com/app/main/rpc/project', 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://www.dncscrub.com/app/main/rpc/project",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "loginId: <loginid>"
  ],
]);

$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://www.dncscrub.com/app/main/rpc/project"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("loginId", "<loginid>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://www.dncscrub.com/app/main/rpc/project")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["loginId"] = '<loginid>'

response = http.request(request)
puts response.read_body

POST

app

main

rpc

project

Create or Update Project

curl --request POST \
  --url https://www.dncscrub.com/app/main/rpc/project \
  --header 'loginId: <loginid>'

const options = {method: 'POST', headers: {loginId: '<loginid>'}};

fetch('https://www.dncscrub.com/app/main/rpc/project', 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://www.dncscrub.com/app/main/rpc/project",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "loginId: <loginid>"
  ],
]);

$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://www.dncscrub.com/app/main/rpc/project"

	req, _ := http.NewRequest("POST", url, nil)

	req.Header.Add("loginId", "<loginid>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://www.dncscrub.com/app/main/rpc/project")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["loginId"] = '<loginid>'

response = http.request(request)
puts response.read_body

Programmatically create new Projects or update existing ones. Projects are the top-level container in DNCScrub for organizing campaigns, scrub options, and Internal DNC lists. If the supplied project_code already exists, the endpoint updates the existing Project. If it does not exist, a new Project is created with a default Campaign.

Request

Headers

Your API Key

Query / Form Parameters

string

required

Project code to insert or update. Will be uppercased and trimmed.If your account has auto-prefixing enabled, the prefix <acctId>_ is added automatically when missing.Pass projId=<acctId> instead of project_code to operate on the Master Project.

string

required

Display name of the Project.

string

FTC Org Id or SAN. When supplied on a new Project, the value is validated against the FTC; if a SAN is supplied, the corresponding Org Id is resolved and stored.

string

Internal handler override. The endpoint normally infers this:

insert_project - new project (auto-selected when project_code does not exist)
update_project - update existing project (auto-selected when it exists)
deactivate_project - mark project inactive
reactivate_project - reactivate an inactive project

string

Pass xml to return a full XML document describing the resulting Project, its Campaigns, and (for SmartBlock-enabled accounts) SmartBlock settings.

string

Free-form project notes.

boolean

Inherit the Master Project’s Internal DNC / DNM database.

boolean

Inherit the Master Project’s EBR / override database.

boolean

Inherit the Master Project’s DNC policy.

boolean

Inherit the Master Project’s national DNC subscription.

boolean

Inherit the Master Project’s training materials.

Example Request

curl --location --request POST \
  'https://www.dncscrub.com/app/main/rpc/project' \
  --header 'loginId: YOUR_API_KEY' \
  --data-urlencode 'project_code=ACME_Q4' \
  --data-urlencode 'project_name=ACME Q4 Outbound' \
  --data-urlencode 'nat_dnc_org_id=12345678'

curl --location --request POST \
  'https://www.dncscrub.com/app/main/rpc/project' \
  --header 'loginId: YOUR_API_KEY' \
  --data-urlencode 'project_code=ACME_Q4' \
  --data-urlencode 'project_name=ACME Q4 (renamed)'

curl --location --request POST \
  'https://www.dncscrub.com/app/main/rpc/project?output=xml' \
  --header 'loginId: YOUR_API_KEY' \
  --data-urlencode 'project_code=ACME_Q4' \
  --data-urlencode 'project_name=ACME Q4 Outbound'

const body = new URLSearchParams({
  project_code: "ACME_Q4",
  project_name: "ACME Q4 Outbound",
  nat_dnc_org_id: "12345678",
});

const res = await fetch("https://www.dncscrub.com/app/main/rpc/project", {
  method: "POST",
  headers: {
    loginId: "YOUR_API_KEY",
    "Content-Type": "application/x-www-form-urlencoded",
  },
  body,
});

console.log(res.status); // 201 on create, 200 on update

using (var client = new HttpClient())
{
    client.DefaultRequestHeaders.Add("loginId", "YOUR_API_KEY");

    var form = new FormUrlEncodedContent(new[]
    {
        new KeyValuePair<string, string>("project_code", "ACME_Q4"),
        new KeyValuePair<string, string>("project_name", "ACME Q4 Outbound"),
        new KeyValuePair<string, string>("nat_dnc_org_id", "12345678"),
    });

    var res = await client.PostAsync(
        "https://www.dncscrub.com/app/main/rpc/project", form);
}

Response

Status Code	Meaning
`200`	Project updated successfully (no body unless `output=xml`)
`201`	Project created successfully (no body unless `output=xml`)
`400`	Validation or save error - reason phrase contains the error message
`403`	Project exists but is inactive (use `handler=reactivate_project`)

When output=xml is supplied, the response body is an XML document rooted at <DncCompliance><DncScrub><Accounts><Account><Projects>...</Projects></Account></Accounts></DncScrub></DncCompliance> containing the Project, its Campaigns, and any FTC Org Id metadata that was just resolved.

Reactivating an Inactive Project

If project_code matches an inactive Project, the endpoint returns 403 Inactive Project unless you explicitly request reactivation:

curl --location --request POST \
  'https://www.dncscrub.com/app/main/rpc/project' \
  --header 'loginId: YOUR_API_KEY' \
  --data-urlencode 'project_code=ACME_Q4' \
  --data-urlencode 'project_name=ACME Q4 Outbound' \
  --data-urlencode 'handler=reactivate_project'

Master Project Operations

Pass projId=<acctId> (with no project_code) to update settings on your account’s Master Project:

curl --location --request POST \
  'https://www.dncscrub.com/app/main/rpc/project' \
  --header 'loginId: YOUR_API_KEY' \
  --data-urlencode 'projId=YOUR_ACCT_ID' \
  --data-urlencode 'nat_dnc_org_id=12345678'

Listing All Projects

There is no separate list endpoint - this same endpoint returns a full project enumeration when you target the Master Project with output=xml and no fields to update. Because no fields change, the call is read-only:

curl --location --request GET \
  'https://www.dncscrub.com/app/main/rpc/project?projId=YOUR_ACCT_ID&output=xml' \
  --header 'loginId: YOUR_API_KEY'

The XML response lists every Project the account can access (including cross-account projects), each Project’s Campaigns, and each Campaign’s status. To list a single Project instead, pass that Project’s projId rather than your account ID. To get details for a single Project, pass that Project’s projId:

curl --location --request GET \
  'https://www.dncscrub.com/app/main/rpc/project?projId=ACME_Q4&output=xml' \
  --header 'loginId: YOUR_API_KEY'

Best Practices

Idempotent Upserts

The same request creates a Project on first call and updates it on subsequent calls. Use the HTTP status code (201 vs 200) to tell the cases apart.

Use output=xml on Create

Adding output=xml to a create request returns the new Project’s full record (including the auto-created default Campaign) so you don’t need a follow-up call to get its IDs.

FTC Org Id Validation

Supplying nat_dnc_org_id on a new Project triggers FTC validation. Make sure the Org Id (or SAN) is correct, or the create will fail with an FTC error message.

Project Code Rules

Project codes are uppercased automatically. Avoid the _ character in your raw code if your account uses auto-prefixing - the prefix delimiter is _.

⌘I

Getting Started

Full Scrub

Litigator-Only Scrub

Reassigned Scrub

Call Deliverability (TrustCall)

Data Enhancement

GeoScrub

Other APIs

Code Examples

Create or Update Project

Request

Headers

Query / Form Parameters

Example Request

Response

Reactivating an Inactive Project

Master Project Operations

Listing All Projects

Best Practices

​Request

​Headers

​Query / Form Parameters

​Example Request

​Response

​Reactivating an Inactive Project

​Master Project Operations

​Listing All Projects

​Best Practices

Request

Headers

Query / Form Parameters

Example Request

Response

Reactivating an Inactive Project

Master Project Operations

Listing All Projects

Best Practices