smtp-2-go

name

smtp-2-go

description

SMTP2GO is an email delivery platform that provides SMTP relay and email APIs for sending transactional and marketing messages, allowing developers and businesses to improve deliverability, monitor performance, and manage outbound email infrastructure across applications and services. Read and write SMTP2GO data through One: subaccount, allowedrecipients, apikeys, allowedsenders, smtpusers, ipauth and more, 68 actions with real parameter documentation. Use whenever the user asks to look something up in SMTP2GO, create or update a record there, or build code against the SMTP2GO API.

SMTP2GO through One

SMTP2GO is an email delivery platform that provides SMTP relay and email APIs for sending transactional and marketing messages, allowing developers and businesses to improve deliverability, monitor performance, and manage outbound email infrastructure across applications and services.

One exposes SMTP2GO through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform smtp-2-go if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm SMTP2GO is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real SMTP2GO account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Subaccount

Action	Method	Path	Action id
Add Subaccount	POST	/v3/subaccount/add	conn_mod_def::GLlCK99HzxA::YTSRkKU4R_SHCutjk0n2JQ
Close a Subaccount	POST	/v3/subaccount/close	conn_mod_def::GLlCK-QSXxA::Xfm9-ebyTFu9b8RZCWZf8Q
Edit a Subaccount	POST	/v3/subaccount/edit	conn_mod_def::GLlCK99qwGA::rwVYDyOTQ6OuurXIBtbncQ
Reinvite a Subaccount	POST	/v3/subaccount/reinvite	conn_mod_def::GLlCK-VARDg::F3rqCwNpTPKCRufvCA3RkA
Reopen a Closed Subaccount	POST	/v3/subaccount/reopen	conn_mod_def::GLlCK_adVbg::U_B81D9nTfmxrhadbFnNNw

AllowedRecipients

Action	Method	Path	Action id
Add Allowed Recipients	POST	/v3/allowed_recipients/add	conn_mod_def::GLlCJgVCckg::YAkcj_KpSAe_xgSZqvYTvw
Remove Allowed Recipients	POST	/v3/allowed_recipients/remove	conn_mod_def::GLlCJhUAsHg::m_ZvvUHKROy7zkcvvni9-A
Update Allowed Recipients	POST	/v3/allowed_recipients/update	conn_mod_def::GLlCJg3ZlsA::qGz1NJR4RmmY6pPDxRNsEg
View Allowed Recipients	POST	/v3/allowed_recipients/view	conn_mod_def::GLlCJgWBBdA::oOVSW0BFQBWbLrMeEYWy_Q

ApiKeys

Action	Method	Path	Action id
Add API Key	POST	/v3/api_keys/add	conn_mod_def::GLlCJoKuqWg::FkZC5yVHSZOutHaj0SW22A
Edit an API Key	PATCH	/v3/api_keys/edit	conn_mod_def::GLlCJw6yLtA::j70bMU9aSuqduilXO-NTzQ
Remove API Key	POST	/v3/api_keys/remove	conn_mod_def::GLlCJw_nLGA::hi5QfqNcSuOUl9GAhIJM-Q
View API Keys	POST	/v3/api_keys/view	conn_mod_def::GLlCJwQy1eA::FnTaTcpsQoeDPWSQISEbyw

AllowedSenders

Action	Method	Path	Action id
Add Allowed Senders	POST	/v3/allowed_senders/add	conn_mod_def::GLlCJolgZEA::ZEDlGjexQRKTmkZU_ybGAA
Remove Allowed Senders	POST	/v3/allowed_senders/remove	conn_mod_def::GLlCJo2fVhA::wzL79IzIS3GHBUUl0JfwrA
Update Allowed Senders	POST	/v3/allowed_senders/update	conn_mod_def::GLlCJo1eCzg::VxBl3_7zSX-ei_5C1W6OKg
View Allowed Senders	POST	/v3/allowed_senders/view	conn_mod_def::GLlCJpYRDIA::hHdbqU0JQ4yHmp0xbRsrvg

SmtpUsers

Action	Method	Path	Action id
Add SMTP User	POST	/v3/users/smtp/add	conn_mod_def::GLlCKu-jUDg::WYUm_SuYTQ-7ML5d2TUXfg
Edit SMTP User	PATCH	/v3/users/smtp/edit	conn_mod_def::GLlCKwITNTA::K3WScf2iQjKQXYX1drcRmQ
Remove an SMTP User	POST	/v3/users/smtp/remove	conn_mod_def::GLlCKtnZ2DA::2wVpieQhQvCrXCmxYODFjw
View SMTP Users	POST	/v3/users/smtp/view	conn_mod_def::GLlCKr7Tfog::Ro5L4yfYQk6YliXTv6ecLw

IpAuth

Action	Method	Path	Action id
Edit an IP Auth	PATCH	/v3/ip_auth/edit	conn_mod_def::GLlCKGyV2ng::x4M0iGy6RgCNbj5fyGAdGQ
Remove IP Auth Entry	POST	/v3/ip_auth/remove	conn_mod_def::GLlCKJ07e2A::uW1Qbg2MSVqMOxLlGOPniw
View IP Auth	POST	/v3/ip_auth/view	conn_mod_def::GLlCKSh5IIg::ycw951YsTamIbaZDoLDCnw

Email

Action	Method	Path	Action id
Search Email	POST	/v3/email/search	conn_mod_def::GLlCKHgbXLA::HePvva92QB-lkaHpoBQL5g
Send Email	POST	/v3/email/send	conn_mod_def::GLlCKKrxJ_A::MexUmS2jRuS_Io5V2S_NDw
Send MIME Email	POST	/v3/email/mime	conn_mod_def::GLlCKHqIPgA::9lzfVS8BQxKvotWM2QKp3g

Domains

Action	Method	Path	Action id
Add Sender Domain	POST	/v3/domain/add	conn_mod_def::GLlCKR_mLkg::FzfMw2BuROKY9RVrA7iDig
Edit Return Path Subdomain	POST	/v3/domain/returnpath	conn_mod_def::GLlCKR4466g::wgd1w3VFRB-Z1u1tEpBebw
Verify a Sender Domain	POST	/v3/domain/verify	conn_mod_def::GLlCKdmJlng::E1Gk-28aQxaM1A29B_x8_g

SingleSenderEmails

Action	Method	Path	Action id
Add Single Sender Emails Using v3	POST	/v3/single_sender_emails/add	conn_mod_def::GLlCKYteY0g::654URHfpTFW-sk8FVb6-GQ
Remove a Single Sender Email	POST	/v3/single_sender_emails/remove	conn_mod_def::GLlCKbUDqHA::PPWmBm0HRsClNwjsw-LbhQ
View Single Sender Emails	POST	/v3/single_sender_emails/view	conn_mod_def::GLlCKj__0-A::NzHMU7lVSoGS0Fuy88rqyQ

Stats

Action	Method	Path	Action id
Email Cycle	POST	/v3/stats/email_cycle	conn_mod_def::GLlCK4JB0EA::_2WwCC-BQmel0OP9n0GcHg
Email History	POST	/v3/stats/email_history	conn_mod_def::GLlCK2Z8qtg::t3Vo1nwvTR6xCT65Khv6lg
Email Spam Stats	POST	/v3/stats/email_spam	conn_mod_def::GLlCK3PcJQA::fyVEdGHtRD6uZ_qSzQle_w

Webhook

Action	Method	Path	Action id
Add Webhook	POST	/v3/webhook/add	conn_mod_def::GLlCLO-y_Yg::7lfl6eb5TCajUV6V5033jw
Edit Webhook	POST	/v3/webhook/edit	conn_mod_def::GLlCLoGVc7A::g9vNCkqZTuati5clQY7Yqg
Remove Webhook	POST	/v3/webhook/remove	conn_mod_def::GLlCLn3a1OA::cEfN_yUuSoSLferzeN0JIg

Suppression

Action	Method	Path	Action id
Add a Suppression	POST	/v3/suppression/add	conn_mod_def::GLlCLGFa8TA::u1kRfwPAR1CSuiUbQAzeuA
Remove a Suppression	POST	/v3/suppression/remove	conn_mod_def::GLlCLGFXvOA::NtFmB8X_TOinE5V1lfDF_w

EmailTemplates

Action	Method	Path	Action id
Delete an Email Template	POST	/v3/template/delete	conn_mod_def::GLlCLOG7AGg::5ZDY8bKER1iwvkTeLpBwxg
Search Email Templates	POST	/v3/template/search	conn_mod_def::GLlCLOGvWAg::-DSzYeVFTmqhewtWXwi5kg

Template

Action	Method	Path	Action id
Edit Template	POST	/v3/template/edit	conn_mod_def::GLlCLQxUyzg::KgMyDdTvTaa7yy9SAABUEg
View Template Details	POST	/v3/template/view	conn_mod_def::GLlCLgw9E8A::2kIUpKAJTC6M6P1MNVnf5g

Activity

Action	Method	Path	Action id
Search Activity	POST	/v3/activity/search	conn_mod_def::GLlCJgWjgfA::SBoIqkD6TcWdqy7fO69B9g

ApiKeyPermissions

Action	Method	Path	Action id
View API Key Permissions	POST	/v3/api_keys/permissions	conn_mod_def::GLlCJv2IXmg::6Rwwrpr0Ry6SYgofYiGsZg

DedicatedIps

Action	Method	Path	Action id
View Dedicated IP Addresses	POST	/v3/dedicated_ips/view	conn_mod_def::GLlCJyK8yGg::BATnLSH_Q2O52eC9xZ5p6A

ArchivedEmail

Action	Method	Path	Action id
View an Archived Email	POST	/v3/archive/email	conn_mod_def::GLlCJ4CvgMg::h0YTmsQ7QZuoPoWceLTmrQ

ArchivedContent

Action	Method	Path	Action id
Search Archived Content	POST	/v3/archive/search	conn_mod_def::GLlCJ4YmZfg::nas7pPX_Rh-5hbnRz_x0Mg

ScheduledEmail

Action	Method	Path	Action id
Remove Scheduled Email	POST	/v3/email/scheduled/remove	conn_mod_def::GLlCJ4x6gBA::tocVf5fNTtKczhw9IcMiTw

ScheduledEmails

Action	Method	Path	Action id
Search Scheduled Emails	POST	/v3/email/scheduled/search	conn_mod_def::GLlCJ5vYH-A::z22E9ER8S3mJNyLyNVXo7Q

EmailBatch

Action	Method	Path	Action id
Send Batch Emails	POST	/v3/email/batch	conn_mod_def::GLlCJ_ps_BA::0owkHXGSSuK4blFnZnvqaQ

TrackingSubdomain

Action	Method	Path	Action id
Edit Tracking Subdomain	POST	/v3/domain/tracking	conn_mod_def::GLlCKQsrzLA::MgY5EhXrRQWHg4o_hKW5wg

DomainSubaccountAccess

Action	Method	Path	Action id
Edit Subaccount Access for a Domain	POST	/v3/domain/subaccount_access	conn_mod_def::GLlCKRLEtyA::PFZHR7LeSBSlr46Lyun3kw

Domain

Action	Method	Path	Action id
Remove Sender Domain	POST	/v3/domain/remove	conn_mod_def::GLlCKYtld8g::1s4cElxTTWqIL_R240exog

SenderDomains

Action	Method	Path	Action id
View Sender Domains	POST	/v3/domain/view	conn_mod_def::GLlCKZphrhg::hE-6XXWMRO-2XB-Q3K3xZg

Sms

Action	Method	Path	Action id
Send SMS	POST	/v3/sms/send	conn_mod_def::GLlCKjpFhOA::AEu5wRj0RpaLho2Ii7mH3g

ReceivedSms

Action	Method	Path	Action id
View Received SMS	POST	/v3/sms/view-received	conn_mod_def::GLlCKjx0sVA::AMjYV9e8Qf6JIscxDZILGw

SentSms

Action	Method	Path	Action id
View Sent SMS	POST	/v3/sms/view-sent	conn_mod_def::GLlCKkG-e6A::YJjztiwtTf26huSgo_2dBg

SmsSummary

Action	Method	Path	Action id
SMS Summary	POST	/v3/sms/summary	conn_mod_def::GLlCKlf-LUg::QKW4FZVtTk6pwbBuhz_KrA

EmailBounces

Action	Method	Path	Action id
Email Bounces	POST	/v3/stats/email_bounces	conn_mod_def::GLlCKrwHwBA::LOW-AVx1QQ6Y373y-2hUtA

EmailUnsubscribes

Action	Method	Path	Action id
Email Unsubscribes	POST	/v3/stats/email_unsubs	conn_mod_def::GLlCK28_3Kg::aexrDCRQTZaBeTvwRCoFjA

EmailSummary

Action	Method	Path	Action id
Email Summary	POST	/v3/stats/email_summary	conn_mod_def::GLlCK4Fi-WA::_g4YirpwT0mvsySSjuRbBw

Suppressions

Action	Method	Path	Action id
View Suppressions	POST	/v3/suppression/view	conn_mod_def::GLlCLGyCHvg::jO7yMdD9QIeFagJJpfZbxA

Templates

Action	Method	Path	Action id
Add an Email Template	POST	/v3/template/add	conn_mod_def::GLlCLHCfjqg::PlBA3oOCTNyTJ7J39D5Gkg

Subaccounts

Action	Method	Path	Action id
Search Subaccounts	POST	/v3/subaccounts/search	conn_mod_def::GLlCLH_lpwg::RYGXglRUR9ObkiCw7x95WA

Webhooks

Action	Method	Path	Action id
View Webhooks	POST	/v3/webhook/view	conn_mod_def::GLlCLoRM4vA::7dWmkNsoRGy7A3MhJNcRRA

When a call fails

The error comes from SMTP2GO, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/smtp-2-go

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.