Skip to main content
POST
Connect an SMTP mailbox
Connects a mailbox by its mail-server settings. POST /v3/outreach/sending-accounts/smtp/test and POST /v3/outreach/sending-accounts/imap/test verify the credentials without saving them. The reading settings are optional. Without them the mailbox sends normally but replies never come back into SnowSEO.
These endpoints take mailbox passwords, so they are not exposed as MCP tools - connecting a mailbox is not something an AI assistant should do on your behalf. Connect mailboxes from Settings → Integrations → Sending accounts in the dashboard.

Authorizations

Authorization
string
header
required

Your SnowSEO API key (sk_...).

Body

application/json
email
string
required

Mailbox address.

smtpHost
string
required

Outgoing mail server.

smtpUser
string
required

SMTP username.

smtpPassword
string
required

SMTP password.

teamId
string
displayName
string | null

Name shown in the From header.

smtpPort
number | null

SMTP port.

smtpEncryption
string

One of: ssl, tls, none. Defaults to tls.

imapHost
string | null

Incoming mail server. Turns on reply reading.

imapPort
number | null

IMAP port.

imapSecure
boolean

Use TLS for IMAP.

imapUser
string | null

IMAP username. Falls back to the SMTP username.

imapPassword
string | null

IMAP password. Falls back to the SMTP password.

Response

Default Response

account
object
canReceive
boolean