Domains: Setup help

Request Domain Remediation

Asks our team to review a domain that Add Domain refused with `BLACKLISTED`. Once approved, add it again.

POSThttps://g.sendcorex.com/v1/domaincommand: request_domain_remediation
i

Needs the domain:create scope on your API key.

i

Up to 5 calls per minute per account. Over that, the command answers RATE_LIMITED.

i

One open request per domain. We answer by email.

Arguments

  • domainstringrequired

    The domain that was refused.

    e.g. "acme.io"

  • justificationstringoptional

    Up 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

  • domain

    The domain.

  • status

    Always pending here.

  • message

    A sentence you can show to your user.

From refused to added

  • 1. Refused

    Add Domain answers BLACKLISTED.

  • 2. Request

    This command. Give as much context as you can.

  • 3. Approved

    Our 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.

  • 401INVALID_API_KEY

    The API key does not exist, was revoked or was disabled in the dashboard.

  • 429RATE_LIMITED

    More than 15 requests/s or 15 in flight for the same IP + API key. Wait the number of seconds in Retry-After.

  • CMDMISSING_SCOPE

    The API key does not have the scope this command needs.

  • CMDINVALID_ARGS

    An argument is invalid: missing or malformed `domain`, `key_size` other than 1024/2048, invalid `email`, a description over 255 characters…

  • CMDALREADY_PENDING

    A remediation request for this domain is already waiting for review.

  • CMDALREADY_APPROVED

    The remediation was already approved: add the domain again.

  • CMDRATE_LIMITED

    This command was called too many times in the last minute by your account. Wait a minute.

  • CMDINTERNAL

    Server error. The detail is only written to the server log.