Sender: Routen
Run Commands
Der einzige Einstiegspunkt für Sender. Senden Sie 1 bis 20 Befehle in einem Request und erhalten Sie ein Ergebnis pro Befehl.
https://g.sendcorex.com/v1/senderGleiches Envelope wie Domains, Contacts und Logs. Die Seiten darunter dokumentieren jeden Befehl.
Fehler werden pro Befehl gemeldet. Ein fehlschlagender Befehl stoppt die anderen nicht, und der HTTP-Status bleibt 200.
Body-Parameter
commandsobject[]erforderlich1 bis 20 Befehle, der Reihe nach ausgeführt. Der gesamte Body darf bis zu 1 MB groß sein.
commands[].commandstringerforderlichlist_senders,get_sender,create_sender,update_sender,update_sender_descriptionoderdelete_sender.commands[].argsobjectoptionalDie Argumente des Befehls. Jeder Wert kann ein
$refauf das Ergebnis eines früheren Befehls sein.commands[].idstringoptionalIhre eigene Kennung für das Ergebnis. Standard ist der Index (
"0","1"…). Pflicht, wenn Sie$refverwenden möchten.
Schnellstart
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1/sender',
{
commands: [
{
command: "list_senders",
id: "all"
},
{
command: "get_sender",
id: "one",
args: {
sender_id: "K7Q2M9XR4TB8WD1ZC6NF3HJP"
}
}
]
},
{ headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);
for (const result of response.data.results) {
if (result.type !== 'SUCCESS') console.error(result.id, result.code, result.message);
else console.log(result.id, result.data);
}Antwort
{
"type": "SUCCESS",
"results": [
{
"command": "list_senders",
"id": "all",
"type": "SUCCESS",
"took_ms": 5,
"data": {
"senders": [
{
"sender_id": "K7Q2M9XR4TB8WD1ZC6NF3HJP",
"email": "hello@acme.com",
"username": "hello",
"domain": "acme.com",
"from_name": "Acme",
"reply_to": "support@acme.com",
"description": "Product updates",
"avatar_color": "#2F6FDB",
"warmup_enabled": false,
"reputation": {
"delivered": 18420,
"bounced": 131,
"spam": 6,
"received_messages": 2210,
"total_emails": 18557,
"has_minimum_volume": true,
"delivery_rate": 99,
"bounce_rate": 1,
"spam_rate": 0,
"engagement_rate": 12,
"score": 100,
"status": "Excellent"
},
"created_at": "2026-09-02T14:40:12.530Z",
"updated_at": "2026-10-20T08:15:33.004Z"
}
]
}
},
{
"command": "get_sender",
"id": "one",
"type": "SUCCESS",
"took_ms": 2,
"data": {
"sender_id": "K7Q2M9XR4TB8WD1ZC6NF3HJP",
"email": "hello@acme.com",
"username": "hello",
"domain": "acme.com",
"from_name": "Acme",
"reply_to": "support@acme.com",
"description": "Product updates",
"avatar_color": "#2F6FDB",
"warmup_enabled": false,
"reputation": {
"delivered": 18420,
"bounced": 131,
"spam": 6,
"received_messages": 2210,
"total_emails": 18557,
"has_minimum_volume": true,
"delivery_rate": 99,
"bounce_rate": 1,
"spam_rate": 0,
"engagement_rate": 12,
"score": 100,
"status": "Excellent"
},
"created_at": "2026-09-02T14:40:12.530Z",
"updated_at": "2026-10-20T08:15:33.004Z"
}
}
]
}Antwortfelder
typeImmer
SUCCESS, wenn der Request selbst angenommen wurde.results[].commandDer Befehl, der dieses Ergebnis erzeugt hat.
results[].idDie von Ihnen gesendete
idoder der Index des Befehls.results[].typeSUCCESSoderERROR.results[].took_msZeit, die der Befehl im Server benötigt hat.
results[].dataDie Ausgabe des Befehls. Nur vorhanden, wenn
typeSUCCESSist.results[].code / messageDer Fehler. Nur vorhanden, wenn
typeERRORist.
Authentifizierung
Verwenden Sie den API Key, den Sie im Dashboard unter Developers → API Keys erstellen, mit den Scopes, die die Befehle brauchen.
AuthorizationSenden Sie
Authorization: <api key>oderAuthorization: Bearer <api key>.sender:readlist_sendersundget_sender.sender:createcreate_sender.sender:updateupdate_senderundupdate_sender_description.sender:deletedelete_sender.Mailbox-TokensDas Webmail-Token funktioniert hier nicht. Es wird mit
WRONG_CREDENTIAL_TYPEabgelehnt.Erlaubte IPsHat der Schlüssel eine IP-Allowlist, erhalten Requests von anderen IPs
403 IP_NOT_ALLOWED.
Verketten mit $ref
Legen Sie einen Sender an und geben Sie seine ID an den nächsten Befehl im selben Request weiter.
create_sender → update_sender_description
{
"commands": [
{
"command": "create_sender",
"id": "new",
"args": {
"username": "news",
"from_name": "Acme News",
"reply_to": "news@acme.com",
"domain": "acme.com"
}
},
{
"command": "update_sender_description",
"args": {
"sender_id": {
"$ref": "new",
"path": "sender_id"
},
"description": "Monthly newsletter"
}
}
]
}Rate Limits
15 Requests / SekundePro IP + API Key. Darüber HTTP 429 mit einem
Retry-After-Header.15 gleichzeitigHöchstens 15 Requests gleichzeitig in Bearbeitung, pro IP + API Key.
Pro Befehl, pro Kontocreate_senderundupdate_sender10/min ·update_sender_description20/min ·delete_sender30/min. Darüber antwortet der Befehl mitRATE_LIMITED.Kein CacheJeder Aufruf liest die Datenbank. Was Sie erhalten, ist immer aktuell.
Fehler
Fehler auf HTTP-Ebene liefern type, code und message. Mit CMD markierte Fehler kommen im Befehlsergebnis zurück, mit HTTP 200.
- 400
INVALID_JSONDer Body ist nicht {"commands":[...]} oder größer als 1 MB.
- 400
INVALID_ARGSDer Request enthält keine Befehle oder mehr als 20.
- 401
MISSING_AUTH_HEADEREs wurde kein Authorization-Header gesendet.
- 401
INVALID_API_KEYDer API Key existiert nicht, wurde widerrufen oder im Dashboard deaktiviert.
- 401
API_KEY_EXPIREDDer API Key hat das im Dashboard festgelegte Ablaufdatum überschritten.
- 401
WRONG_CREDENTIAL_TYPEEs wurde ein Mailbox-Token gesendet. Die Senders API braucht einen API Key aus dem Dashboard.
- 403
IP_NOT_ALLOWEDDer Request kam von einer IP, die nicht zu den erlaubten IPs des Schlüssels gehört.
- 403
ACCOUNT_BLOCKEDDas Konto ist gesperrt.
- 403
MISSING_SCOPEDer Schlüssel hat keinen `sender:*`-Scope, daher kann kein Befehl laufen.
- 429
RATE_LIMITEDMehr als 15 Requests/s oder 15 gleichzeitig für dieselbe IP + API Key. Warten Sie die Sekunden aus Retry-After ab.
- 503
AUTH_UNAVAILABLEDie Authentifizierung ist vorübergehend nicht verfügbar. Versuchen Sie es erneut.
- CMD
UNKNOWN_COMMANDDer Befehlsname existiert nicht.
- CMD
INTERNALServerfehler. Details werden nur ins Server-Log geschrieben.