Domains: Setup help
Request Domain Remediation
Asks our team to review a domain that Add Domain refused with `BLACKLISTED`. Once approved, add it again.
https://g.sendcorex.com/v1/domaincommand: request_domain_remediationNeeds the domain:create scope on your API key.
Up to 5 calls per minute per account. Over that, the command answers RATE_LIMITED.
One open request per domain. We answer by email.
Arguments
domainstringrequiredThe domain that was refused.
e.g.
"acme.io"justificationstringoptionalUp to 2000 characters. Tell us what the domain is used for and, if it was listed, what you did to get delisted.
e.g.
"New owner since August, previous site removed, delisted from Spamhaus on 2026-10-12."
Quick start
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/domain',
{
commands: [
{
command: "request_domain_remediation",
args: {
domain: "acme.io",
justification: "New owner since August, previous site removed, delisted from Spamhaus on 2026-10-12."
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);
const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);Response
{
"type": "SUCCESS",
"results": [
{
"command": "request_domain_remediation",
"id": "0",
"type": "SUCCESS",
"took_ms": 14,
"data": {
"domain": "acme.io",
"status": "pending",
"message": "Your request has been submitted. Our team will review it and contact you shortly."
}
}
]
}Response fields
domainThe domain.
statusAlways
pendinghere.messageA sentence you can show to your user.
From refused to added
1. RefusedAdd Domain answers
BLACKLISTED.2. RequestThis command. Give as much context as you can.
3. ApprovedOur team reviews it and gets back to you. Then call Add Domain again: the blocklist check is skipped for this domain on your account.
Already approved?A new request answers
ALREADY_APPROVED: just add the domain.
Errors
HTTP-level errors return type, code and message. Errors marked CMD come back inside the command result, with HTTP 200.
- 401
INVALID_API_KEYThe API key does not exist, was revoked or was disabled in the dashboard.
- 429
RATE_LIMITEDMore than 15 requests/s or 15 in flight for the same IP + API key. Wait the number of seconds in Retry-After.
- CMD
MISSING_SCOPEThe API key does not have the scope this command needs.
- CMD
INVALID_ARGSAn argument is invalid: missing or malformed `domain`, `key_size` other than 1024/2048, invalid `email`, a description over 255 characters…
- CMD
ALREADY_PENDINGA remediation request for this domain is already waiting for review.
- CMD
ALREADY_APPROVEDThe remediation was already approved: add the domain again.
- CMD
RATE_LIMITEDThis command was called too many times in the last minute by your account. Wait a minute.
- CMD
INTERNALServer error. The detail is only written to the server log.