Verify IMAP + SMTP connection | Runtype Documentation

Tests IMAP and SMTP connectivity for an email surface using the supplied credentials.

AuthorizationBearer

API key or Clerk session token

surfaceIdstringRequired

This endpoint expects an object.

imapHoststringRequired>=1 character

imapPasswordstringRequired>=1 character

imapPortintegerRequired1-65535

imapUsernamestringRequired>=1 character

smtpHoststringRequired>=1 character

smtpPasswordstringRequired>=1 character

smtpPortintegerRequired1-65535

smtpUsernamestringRequired>=1 character

imapSecurebooleanOptional

mailboxstringOptional

pollIntervalMinutesintegerOptional1-60

smtpSecurebooleanOptional

Verification results for IMAP and SMTP

imapobject

smtpobject

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

$	curl -X POST https://api.runtype.com/v1/messaging/imap/surfaceId/verify \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"imapHost": "imap.mailprovider.com",
>	"imapPassword": "SecurePass123!",
>	"imapPort": 993,
>	"imapUsername": "user@example.com",
>	"smtpHost": "smtp.mailprovider.com",
>	"smtpPassword": "SecurePass123!",
>	"smtpPort": 587,
>	"smtpUsername": "user@example.com"
>	}'

$	curl -X POST https://api.runtype.com/v1/messaging/imap/surfaceId/verify \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"imapHost": "imap.mailprovider.com",
>	"imapPassword": "SecurePass123!",
>	"imapPort": 993,
>	"imapUsername": "user@example.com",
>	"smtpHost": "smtp.mailprovider.com",
>	"smtpPassword": "SecurePass123!",
>	"smtpPort": 587,
>	"smtpUsername": "user@example.com"
>	}'