Skip to main content
The add_ebr tool adds Existing Business Relationship records to your DNCScrub account. An EBR can provide an exemption to DNC rules, allowing you to contact numbers that would otherwise be restricted.

​
Parameters

​
records
array
required
Array of EBR records to add.
​
loginId
string
API key. Only required if not provided via the x-dncscrub-api-key HTTP header.
​
keepBetterEBR
boolean
If true, existing EBR records with longer exemption periods won’t be overwritten.

​
Response

​
success
boolean
Whether the API call succeeded.
​
recordsAdded
number
Number of EBR records successfully added.
​
errorCode
string
Machine-readable error code (when failed).
​
errorMessage
string
Human-readable error description (when failed).

​
EBR Expiration Rules

EBR TypeFederal Exemption Period
Sale/Purchase (S)18 months from last transaction
Inquiry (I)3 months from inquiry date
State rules may have shorter exemption periods. The scrub API accounts for state-specific rules automatically.

​
Examples

{
  "records": [
    {
      "phoneNumber": "7075712071",
      "dateOfLastContact": "2024-06-14",
      "type": "S",
      "brand": "Acme Corp"
    }
  ]
}

​
Usage Notes

  • Use accurate dates—the dateOfLastContact should be the actual business relationship date, not today’s date
  • Choose the correct EBR type: using the wrong type could create compliance issues
  • The referenceNum field is useful for audit trails and tracing back to your CRM records
  • Set keepBetterEBR: true to prevent accidentally downgrading a Sale EBR to an Inquiry EBR