Create a key to copy examples filled with your team.
Errors
Status codes and error strings the API returns.
REST errors are a JSON object with error. Node AUTH uses the same shape, plus ok: false.
REST
| Status | error |
|---|---|
401 |
Missing or invalid Bearer token. |
403 |
kyc_required. Cluster or inbox create before KYC. |
403 |
cluster_not_ready. Cluster is not sending_ready. |
403 |
domain_unverified. from is not a verified sending domain. |
403 |
credential_missing. No live SMTP credential for that cluster and tenant. |
403 |
suppressed. A recipient is on the suppression list. |
403 |
Token used against another team's team_id. |
422 |
invalid. from or to is required. |
502 |
inject_failed. The cluster did not accept the message. |
Node AUTH
SMTP AUTH and HTTP inject phone home to /node_api/authentication. Failures count toward the AUTH budget.
| Status | error |
|---|---|
429 |
rate_limited. 20 failed attempts in 10 minutes for that IP and username. |
401 |
invalid_credentials. Unknown user, bad password, or the node will not accept that credential. |
403 |
tenant_mismatch. The tenant param does not match the credential's tenant slug. |
403 |
unverified_domain. The domain param is missing, unverified, or suspended. |