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.

About

PostShiba is the transactional email platform that powers Bento behind the scenes. You can build your own products, like Bento, on top of it.

© 2026 PostShiba by Backpack Internet Pty. Ltd. All rights reserved.

The same policies that govern Bento are applied to PostShiba Privacy | Terms | Security