[{"data":1,"prerenderedAt":679},["ShallowReactive",2],{"navigation":3,"\u002Fdocs\u002Fgetting-started\u002F":121,"\u002Fdocs\u002Fgetting-started\u002F-surround":675},[4,8,22,26,43,104],{"title":5,"path":6,"stem":7},"Getting Started","\u002Fdocs\u002Fgetting-started","1.docs\u002F1.getting-started",{"title":9,"path":10,"stem":11,"children":12,"page":21},"Setup","\u002Fdocs\u002Fsetup","1.docs\u002F2.setup",[13,17],{"title":14,"path":15,"stem":16},"Domain","\u002Fdocs\u002Fsetup\u002Fdomain","1.docs\u002F2.setup\u002F2.domain",{"title":18,"path":19,"stem":20},"Email","\u002Fdocs\u002Fsetup\u002Faccount","1.docs\u002F2.setup\u002F3.account",false,{"title":23,"path":24,"stem":25},"Email Testing API","\u002Fdocs\u002Fapi","1.docs\u002F3.api",{"title":27,"path":28,"stem":29,"children":30,"page":21},"Features","\u002Fdocs\u002Ffeatures","1.docs\u002F4.features",[31,35,39],{"title":32,"path":33,"stem":34},"Account","\u002Fdocs\u002Ffeatures\u002Faccount","1.docs\u002F4.features\u002F1.account",{"title":36,"path":37,"stem":38},"Mailbox","\u002Fdocs\u002Ffeatures\u002Fmailbox","1.docs\u002F4.features\u002F2.mailbox",{"title":40,"path":41,"stem":42},"Messages","\u002Fdocs\u002Ffeatures\u002Fmessage","1.docs\u002F4.features\u002F3.message",{"title":44,"path":45,"stem":46,"children":47,"page":21},"Guides","\u002Fdocs\u002Fguides","1.docs\u002F5.guides",[48,52,56,60,64,68,72,76,80,84,88,92,96,100],{"title":49,"path":50,"stem":51},"SMTP Test","\u002Fdocs\u002Fguides\u002Fsend-test-email","1.docs\u002F5.guides\u002F01.send-test-email",{"title":53,"path":54,"stem":55},"API Quickstart","\u002Fdocs\u002Fguides\u002Femail-testing-api","1.docs\u002F5.guides\u002F02.email-testing-api",{"title":57,"path":58,"stem":59},"CI","\u002Fdocs\u002Fguides\u002Fci","1.docs\u002F5.guides\u002F03.ci",{"title":61,"path":62,"stem":63},"Catch-All","\u002Fdocs\u002Fguides\u002Fcatch-all","1.docs\u002F5.guides\u002F04.catch-all",{"title":65,"path":66,"stem":67},"SPF, DKIM, DMARC","\u002Fdocs\u002Fguides\u002Fspf-dkim-dmarc","1.docs\u002F5.guides\u002F05.spf-dkim-dmarc",{"title":69,"path":70,"stem":71},"Playwright","\u002Fdocs\u002Fguides\u002Fe2e","1.docs\u002F5.guides\u002F06.e2e",{"title":73,"path":74,"stem":75},"Cypress","\u002Fdocs\u002Fguides\u002Fcypress","1.docs\u002F5.guides\u002F07.cypress",{"title":77,"path":78,"stem":79},"Email Clients","\u002Fdocs\u002Fguides\u002Femail-clients","1.docs\u002F5.guides\u002F08.email-clients",{"title":81,"path":82,"stem":83},"AI Agents","\u002Fdocs\u002Fguides\u002Fagents","1.docs\u002F5.guides\u002F09.agents",{"title":85,"path":86,"stem":87},"Local Development","\u002Fdocs\u002Fguides\u002Flocal-development","1.docs\u002F5.guides\u002F10.local-development",{"title":89,"path":90,"stem":91},"Size Limits","\u002Fdocs\u002Fguides\u002Femail-size-limits","1.docs\u002F5.guides\u002F11.email-size-limits",{"title":93,"path":94,"stem":95},"OTP & Magic Links","\u002Fdocs\u002Fguides\u002Fotp-magic-links","1.docs\u002F5.guides\u002F12.otp-magic-links",{"title":97,"path":98,"stem":99},"IMAP & POP3","\u002Fdocs\u002Fguides\u002Fimap-pop3","1.docs\u002F5.guides\u002F13.imap-pop3",{"title":101,"path":102,"stem":103},"Nodemailer","\u002Fdocs\u002Fguides\u002Fnodemailer","1.docs\u002F5.guides\u002F14.nodemailer",{"title":105,"path":106,"stem":107,"children":108,"page":21},"Alternatives","\u002Fdocs\u002Falternatives","1.docs\u002F6.alternatives",[109,113,117],{"title":110,"path":111,"stem":112},"Mailtrap","\u002Fdocs\u002Falternatives\u002Fmailtrap","1.docs\u002F6.alternatives\u002F1.mailtrap",{"title":114,"path":115,"stem":116},"Mailosaur","\u002Fdocs\u002Falternatives\u002Fmailosaur","1.docs\u002F6.alternatives\u002F2.mailosaur",{"title":118,"path":119,"stem":120},"Mailinator","\u002Fdocs\u002Falternatives\u002Fmailinator","1.docs\u002F6.alternatives\u002F3.mailinator",{"id":122,"title":5,"body":123,"description":670,"extension":671,"meta":672,"navigation":435,"path":6,"seo":673,"stem":7,"__hash__":674},"docs\u002F1.docs\u002F1.getting-started.md",{"type":124,"value":125,"toc":664},"minimark",[126,139,190,206,211,214,242,249,256,260,263,345,349,357,491,498,601,605,660],[127,128,129,130,134,135,138],"p",{},"You need a domain whose DNS you can edit. A subdomain such as ",[131,132,133],"code",{},"test.example.com"," is enough, and mail for ",[131,136,137],{},"example.com"," stays where it is.",[140,141,142,151,160,172,179,182],"ol",{},[143,144,145,150],"li",{},[146,147,149],"a",{"href":148},"\u002Fsignup\u002F","Sign up"," and log in",[143,152,153,154,159],{},"Go to ",[146,155,158],{"href":156,"target":157},"\u002Fdomains\u002F","_blank","Domains"," and add your domain",[143,161,162,163,166,167,171],{},"Add an MX record pointing to ",[131,164,165],{},"mx.smtp.dev"," at your DNS provider (",[146,168,170],{"href":169},"\u002Fdocs\u002Fsetup\u002Fdomain\u002F","details",")",[143,173,153,174,178],{},[146,175,177],{"href":176,"target":157},"\u002Faccounts\u002F","Accounts"," and create an email address on that domain",[143,180,181],{},"Send an email to that address from your app",[143,183,184,185,189],{},"Open the account in ",[146,186,188],{"href":187},"\u002Fmail\u002Faccounts\u002F","Mail"," - your email should be there",[191,192,193],"note",{},[127,194,195,196,200,201,205],{},"You can also use any email client over ",[146,197,199],{"href":198},"\u002Fdocs\u002Fsetup\u002Faccount\u002F","IMAP, POP3, SMTP"," and ",[146,202,204],{"href":203},"\u002Fdocs\u002Fapi\u002F","API",".",[207,208,210],"h2",{"id":209},"check-it-works","Check It Works",[127,212,213],{},"Confirm the MX record before you send anything:",[215,216,221],"pre",{"className":217,"code":218,"language":219,"meta":220,"style":220},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","dig +short MX test.example.com\n","bash","",[131,222,223],{"__ignoreMap":220},[224,225,228,232,236,239],"span",{"class":226,"line":227},"line",1,[224,229,231],{"class":230},"sBMFI","dig",[224,233,235],{"class":234},"sfazB"," +short",[224,237,238],{"class":234}," MX",[224,240,241],{"class":234}," test.example.com\n",[127,243,244,245,248],{},"It should print ",[131,246,247],{},"mx.smtp.dev."," after a priority number. Until it does, mail for the domain goes to its old destination, or nowhere.",[127,250,251,252,205],{},"Then send the new address a message from any mailbox you have. The domain receives real email, so your work or personal address works as the sender. If nothing arrives, check DNS first: see ",[146,253,255],{"href":254},"\u002Fdocs\u002Fsetup\u002Fdomain\u002F#troubleshooting","troubleshooting",[207,257,259],{"id":258},"how-mail-gets-in","How Mail Gets In",[127,261,262],{},"Mail reaches an account by one of two routes, and most setups use both.",[264,265,266,284],"table",{},[267,268,269],"thead",{},[270,271,272,275,278],"tr",{},[273,274],"th",{},[273,276,277],{},"Over MX",[273,279,280,281],{},"Through ",[131,282,283],{},"send.smtp.dev",[285,286,287,299,312,323,334],"tbody",{},[270,288,289,293,296],{},[290,291,292],"td",{},"Sender",[290,294,295],{},"Anything on the internet: your email provider, another service, your own inbox",[290,297,298],{},"Your app or test, logged in as a sandbox account",[270,300,301,303,306],{},[290,302,9],{},[290,304,305],{},"The MX record from step 3",[290,307,308,309,171],{},"The account's address and password (",[146,310,311],{"href":198},"settings",[270,313,314,317,320],{},[290,315,316],{},"Delivers to",[290,318,319],{},"Accounts on your domains",[290,321,322],{},"Accounts in your sandbox, and nowhere else",[270,324,325,328,331],{},[290,326,327],{},"SPF, DKIM, DMARC results",[290,329,330],{},"Yes",[290,332,333],{},"No. The message never crosses your DNS",[270,335,336,339,342],{},[290,337,338],{},"What it tests",[290,340,341],{},"The provider and DNS that production uses",[290,343,344],{},"Your app's own SMTP code, with no way to email a customer",[207,346,348],{"id":347},"over-the-api","Over the API",[127,350,351,352,356],{},"The same flow, scripted. Create a key on the ",[146,353,355],{"href":354,"target":157},"\u002Ftokens\u002F","API Keys"," page first; the MX record from step 3 still has to exist.",[215,358,360],{"className":217,"code":359,"language":219,"meta":220,"style":220},"curl -X POST https:\u002F\u002Fapi.smtp.dev\u002Fdomains \\\n  -H \"X-API-KEY: $SMTP_DEV_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"domain\": \"test.example.com\"}'\n\ncurl -X POST https:\u002F\u002Fapi.smtp.dev\u002Faccounts \\\n  -H \"X-API-KEY: $SMTP_DEV_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\"address\": \"qa@test.example.com\", \"password\": \"use-a-secret\"}'\n",[131,361,362,380,401,415,430,437,451,466,479],{"__ignoreMap":220},[224,363,364,367,370,373,376],{"class":226,"line":227},[224,365,366],{"class":230},"curl",[224,368,369],{"class":234}," -X",[224,371,372],{"class":234}," POST",[224,374,375],{"class":234}," https:\u002F\u002Fapi.smtp.dev\u002Fdomains",[224,377,379],{"class":378},"sTEyZ"," \\\n",[224,381,383,386,390,393,396,399],{"class":226,"line":382},2,[224,384,385],{"class":234},"  -H",[224,387,389],{"class":388},"sMK4o"," \"",[224,391,392],{"class":234},"X-API-KEY: ",[224,394,395],{"class":378},"$SMTP_DEV_API_KEY",[224,397,398],{"class":388},"\"",[224,400,379],{"class":378},[224,402,404,406,408,411,413],{"class":226,"line":403},3,[224,405,385],{"class":234},[224,407,389],{"class":388},[224,409,410],{"class":234},"Content-Type: application\u002Fjson",[224,412,398],{"class":388},[224,414,379],{"class":378},[224,416,418,421,424,427],{"class":226,"line":417},4,[224,419,420],{"class":234},"  -d",[224,422,423],{"class":388}," '",[224,425,426],{"class":234},"{\"domain\": \"test.example.com\"}",[224,428,429],{"class":388},"'\n",[224,431,433],{"class":226,"line":432},5,[224,434,436],{"emptyLinePlaceholder":435},true,"\n",[224,438,440,442,444,446,449],{"class":226,"line":439},6,[224,441,366],{"class":230},[224,443,369],{"class":234},[224,445,372],{"class":234},[224,447,448],{"class":234}," https:\u002F\u002Fapi.smtp.dev\u002Faccounts",[224,450,379],{"class":378},[224,452,454,456,458,460,462,464],{"class":226,"line":453},7,[224,455,385],{"class":234},[224,457,389],{"class":388},[224,459,392],{"class":234},[224,461,395],{"class":378},[224,463,398],{"class":388},[224,465,379],{"class":378},[224,467,469,471,473,475,477],{"class":226,"line":468},8,[224,470,385],{"class":234},[224,472,389],{"class":388},[224,474,410],{"class":234},[224,476,398],{"class":388},[224,478,379],{"class":378},[224,480,482,484,486,489],{"class":226,"line":481},9,[224,483,420],{"class":234},[224,485,423],{"class":388},[224,487,488],{"class":234},"{\"address\": \"qa@test.example.com\", \"password\": \"use-a-secret\"}",[224,490,429],{"class":388},[127,492,493,494,497],{},"Everything in the UI maps to a ",[146,495,496],{"href":203},"REST endpoint",", so whatever you set up by hand you can also script.",[264,499,500,508],{},[267,501,502],{},[270,503,504,506],{},[273,505],{},[273,507],{},[285,509,510,520,539,554,568,578,591],{},[270,511,512,517],{},[290,513,514],{},[515,516,158],"strong",{},[290,518,519],{},"Your own domains and subdomains, isolated from each other.",[270,521,522,526],{},[290,523,524],{},[515,525,177],{},[290,527,528,529,533,534,538],{},"Email addresses with mailboxes, passwords, and storage. ",[146,530,532],{"href":531},"\u002Fdocs\u002Ffeatures\u002Faccount\u002F#plus-sign-aliasing","Plus-sign aliasing"," on every plan, and ",[146,535,537],{"href":536},"\u002Fdocs\u002Ffeatures\u002Faccount\u002F#catch-all-addresses","catch-all"," on Pro and Max.",[270,540,541,546],{},[290,542,543],{},[515,544,545],{},"Mailboxes",[290,547,548,549,553],{},"Inbox, Sent, Trash, Drafts, Junk by default. ",[146,550,552],{"href":551},"\u002Fdocs\u002Ffeatures\u002Fmailbox\u002F","Create more"," as needed.",[270,555,556,560],{},[290,557,558],{},[515,559,40],{},[290,561,562,563,567],{},"HTML and plain text views, raw SMTP source, ",[146,564,566],{"href":565},"\u002Fdocs\u002Ffeatures\u002Fmessage\u002F#email-verification","SPF\u002FDKIM\u002FDMARC checks",", attachments.",[270,569,570,575],{},[290,571,572],{},[515,573,574],{},"Compose",[290,576,577],{},"Send test emails between accounts from the browser.",[270,579,580,585],{},[290,581,582],{},[515,583,584],{},"API Tokens",[290,586,587,588,205],{},"Keys for the ",[146,589,590],{"href":203},"REST API",[270,592,593,598],{},[290,594,595],{},[515,596,597],{},"Real-time",[290,599,600],{},"New messages are pushed over SSE.",[207,602,604],{"id":603},"next-steps","Next Steps",[606,607,608,614,620,634,641,647,654],"ul",{},[143,609,610,613],{},[146,611,49],{"href":612},"\u002Fdocs\u002Fguides\u002Fsend-test-email\u002F",": send a test email with swaks, curl, or your app's mailer, and read it back.",[143,615,616,619],{},[146,617,53],{"href":618},"\u002Fdocs\u002Fguides\u002Femail-testing-api\u002F",": create an inbox per test, wait for the message, and assert on it.",[143,621,622,625,626,629,630,633],{},[146,623,57],{"href":624},"\u002Fdocs\u002Fguides\u002Fci\u002F",", ",[146,627,69],{"href":628},"\u002Fdocs\u002Fguides\u002Fe2e\u002F",", and ",[146,631,73],{"href":632},"\u002Fdocs\u002Fguides\u002Fcypress\u002F",": the same checks in your pipeline and browser tests.",[143,635,636,640],{},[146,637,639],{"href":638},"\u002Fdocs\u002Fguides\u002Fotp-magic-links\u002F","OTP Codes and Magic Links",": read the code out of the email and finish the login in a test.",[143,642,643,646],{},[146,644,101],{"href":645},"\u002Fdocs\u002Fguides\u002Fnodemailer\u002F",": send from Node and assert on links, headers, and attachments.",[143,648,649,653],{},[146,650,652],{"href":651},"\u002Fdocs\u002Fguides\u002Fimap-pop3\u002F","IMAP and POP3",": read an inbox by hand with openssl, or from curl, Python, and Node.",[143,655,656,659],{},[146,657,85],{"href":658},"\u002Fdocs\u002Fguides\u002Flocal-development\u002F",": one SMTP host for your laptop, CI, and staging.",[661,662,663],"style",{},"html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}",{"title":220,"searchDepth":382,"depth":382,"links":665},[666,667,668,669],{"id":209,"depth":382,"text":210},{"id":258,"depth":382,"text":259},{"id":347,"depth":382,"text":348},{"id":603,"depth":382,"text":604},"Point an MX record at mx.smtp.dev, create an account, and send your app's first test email. Read it over IMAP, POP3, API, or the web UI.","md",{},{"title":5,"description":670},"r-6GZMWg4ciVpsq3s2pj-hRaItv_odwgh4CFjiG-XoE",[676,677],null,{"title":14,"path":15,"stem":16,"description":678,"children":-1},"Point your domain's MX record at mx.smtp.dev to receive test email. Root domains, subdomains, DNS propagation, and what to check when mail doesn't arrive.",1794505289761]