Skip to content

SMTP Server

Pode has an inbuilt SMTP server for receiving Email which automatically creates a TCP listener on port 25 - unless you specify a different port via the Add-PodeEndpoint function.

Unlike with web servers that use the Route functions, SMTP servers use the Handler functions, which let you specify logic for handling responses from TCP streams.


You can setup multiple different Handlers to run different logic for one Email.


To create a Handler for the inbuilt SMTP server you can use the following example:

Start-PodeServer {
    Add-PodeEndpoint -Address * -Port 25 -Protocol Smtp

    Add-PodeHandler -Type Smtp -Name 'Main' -ScriptBlock {
        Write-Host $SmtpEvent.Email.From
        Write-Host $SmtpEvent.Email.To
        Write-Host $SmtpEvent.Email.Body

Starting this server will listen for incoming email on localhost:25. The Handler will have access to the $SmtpEvent object (see below), which contains information about the Email.

An example of sending Email to the above server via Send-MailMessage:

Send-MailMessage -SmtpServer localhost -To '' -From '' -Body 'Hello' -Subject 'Hi there' -Port 25


The SMTP server also accepts attachments, which are available in a Handler via $SmtpEvent.Email.Attachments. This property contains a list of available attachments on the Email, each attachment has a Name and Bytes properties - the latter being the raw byte content of the attachment.

An attachment also has a .Save(<path>) method. For example, if the Email has an a single attachment: an example.png file, and you wish to save it, then the following will save the file to C:\temp\example.png:

Add-PodeHandler -Type Smtp -Name 'Main' -ScriptBlock {



The SMTP Handler will be passed the $SmtpEvent object, that contains the Request, Response, and Email properties:

Name Type Description
Request object The raw Request object
Response object The raw Response object
Lockable hashtable A synchronized hashtable that can be used with Lock-PodeObject
Email hashtable An object containing data from the email, as seen below


The Email property contains the following properties:

Name Type Description
From string The email address of the person sending the email
To string[] The email addresses receiving the email (this is to, cc, and bcc)
Subject string The subject of the email
Body string The body of the email, decoded depending on content type/encoding
IsUrgent boolean This will be true if the Priority/Importance of the email is High, otherwise false
ContentType string The content type of the original email body
ContentEncoding string The content encoding of the original email body
Headers hashtable A list of all the headers received for the email
Data string The full raw data of the email
Attachments PodeSmtpAttachment[] An list of SMTP attachments, containing the Name and Bytes of the attachment
Back to top