Deliverability Network
The IPs your SMTP and IMAP mailboxes log in through. 4 endpoints, each also a tool for your AI through MCP. Authentication and errors are on the overview.
Where your mailboxes connect from
GET/api/v1/sending-ip
SMTP/IMAP mailboxes connect through the Deliverability Network: the shared network on every plan, dedicated IPs, or your own proxy (API and MCP only). Microsoft and Gmail API mailboxes need none.
MCP tool get_sending_ipRead-only
Returns
requiredrequiredboolean- False only in development: mailboxes may then connect directly
ownrequiredobject | nullproxiesrequiredobject[]waitingrequirednumber- Mailboxes waiting for a sending IP
directrequirednumber- Microsoft and Gmail API mailboxes, which need no proxy
dedicatedrequiredobject
curl https://ballast.to/api/v1/sending-ip \
-H "Authorization: Bearer $BALLAST_API_KEY"Test your own proxy without saving
POST/api/v1/sending-ip/own/test
Logs one of your SMTP/IMAP mailboxes in through it (or checks Gmail answers through it when you have none) and reads its IP type from IPinfo.
MCP tool test_own_proxyOwners and admins
Parameters
urlrequiredstring- socks5://user:pass@host:port or http://user:pass@host:port
Returns
okrequiredbooleanerrorrequiredstring | nullexitIprequiredstring | nullcountryrequiredstring | nullipTyperequiredstring | null- IPinfo network type: isp is what you want; hosting means a datacenter
loginrequiredobject | null- SMTP AUTH and IMAP LOGIN of one of your mailboxes through the proxy
handshakerequiredobject | null- Gmail's SMTP 587 and IMAP 993 answering through the proxy
curl -X POST https://ballast.to/api/v1/sending-ip/own/test \
-H "Authorization: Bearer $BALLAST_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"<url>"}'Use your own proxy
PUT/api/v1/sending-ip/own
Tested first; saved only when it passes. Every SMTP/IMAP mailbox of the workspace then connects through it instead of the pool. Free on every plan.
MCP tool set_own_proxyOwners and admins
Parameters
urlrequiredstring
Returns
savedrequiredbooleantestrequiredobject
curl -X PUT https://ballast.to/api/v1/sending-ip/own \
-H "Authorization: Bearer $BALLAST_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"<url>"}'Stop using your own proxy
DELETE/api/v1/sending-ip/own
Your SMTP/IMAP mailboxes go back to the shared pool (they wait if it has no room).
MCP tool remove_own_proxyOwners and admins
Returns
okrequiredtruewaitingrequirednumber
curl -X DELETE https://ballast.to/api/v1/sending-ip/own \
-H "Authorization: Bearer $BALLAST_API_KEY"