SMTPit Pro

Next Generation Email plug-in

Functions

There are two ways to view the SMTPit Pro function reference, the Function Reference below, and the Function Reference Browser in a new window.

Function Reference

The Function Reference is a complete reference for SMTPit Pro functions. Click on a function title to view more information which includes the function description, parameter information, example usage and more.

Function Reference Browser

function_browser

The Function Reference Browser offers better navigation for the SMTPit Pro functions, you can Launch Function Browser in a new window.


Function Reference

  • SMTPit_AddEmailHeader

    The SMTPit_AddEmailHeader function adds extra email headers to your email message. The "Headers" parameter takes a name and value pair string. Multiple headers can be added by separating name and... read more

  • SMTPit_Clear

    The SMTPit_Clear function clears all values that have been set with the External Functions. This allows you to send a new message without any lingering values. However, you can also clear only... read more

  • SMTPit_Configure

    Calling this function with no parameters will open the SMTPit Pro Configuration Dialog. You can optionally open to a specific tab by specifying the name of the tab as the "Option" parameter. This... read more

  • SMTPit_Connect

    You can use the "SMTPit_Connect" function to specifically connect to your mail server rather than letting the "SMTPit_Send" function connect for you. When you normally use the "SMTPit_Send"... read more

  • SMTPit_Disconnect

    If you use SMTPit_Connect to connect to your mail server manually (instead of letting SMTPit_Send do it), then you must call SMTPit_Disconnect to disconnect from your mail server. Otherwise, SMTPit... read more

  • SMTPit_File_Copy

    You can use this function to copy a file to a new... read more

  • SMTPit_File_Delete

    You can use this function to delete a... read more

  • SMTPit_File_Exists

    This function will check to see if a file... read more

  • SMTPit_File_Export

    This function will export a file from a container to a specified path. SMTPit Pro will use the name of the file in the container unless you specify a name with the "SaveAs"... read more

  • SMTPit_File_GetPath

    You can use the SMTPit_File_GetPath to retrieve a variety of paths including: Database, FileMaker, Root, System, Desktop, Preferences, Temporary, Applications, or Documents. This function can be... read more

  • SMTPit_File_Move

    You can use this function to move a file to a new... read more

  • SMTPit_File_Rename

    You can use this function to rename a... read more

  • SMTPit_File_SelectFileWithDialog

    This function will display a file chooser dialog. You can set the location to open the dialog to, as well as display a custom prompt... read more

  • SMTPit_File_SelectFolderWithDialog

    This function will display a folder chooser dialog. You can set the location to open the dialog to, as well as display a custom prompt... read more

  • SMTPit_File_Size

    This function returns the size of a... read more

  • SMTPit_GetSendValue

    This function retrieves values entered in the last Email Window or last email sent. It can be used for archiving the sent email. You can also use this function in concert with the "SMTPit_Send"... read more

  • SMTPit_IsConnected

    This function will tell you whether or not you are currently connected to a mail... read more

  • SMTPit_MergeText

    With SMTPit Pro, you can use Merge Fields in your email messages. A merge field is a tag representing a field which will get replaced with the field's contents when the message is sent. For... read more

  • SMTPit_QuickSet

    The SMTPit_QuickSet function allows you to set the From, To, Subject, and TextBody in a quick an simple format. You can also use functions for each of these... read more

  • SMTPit_Register

    You can use this function to Register the plug-in from a script instead of through the Configuration Dialog. This is useful when the plug-in is being distributed to many computers, allowing you to... read more

  • SMTPit_Send

    The SMTPit_Send function first checks to make sure you have assigned enough fields to send an email. If everything checks out, it attempts to send the email to your mail server. If there is a problem... read more

  • SMTPit_SendWithDialog

    This function presents the user with a dialog for composing an email. There is both a Simple and Advanced version of the dialog. (The Simple version looks like the Message Dialog in MMEmail). If... read more

  • SMTPit_SetAttachment

    The SMTPit_SetAttachment function allows you to attach a file from your hard drive or network to the current email being sent. You must specify the full path and filename of the file. You can set... read more

  • SMTPit_SetAttachmentWithDialog

    This function presents you with a standard open file dialog that lets you choose a file from your hard drive. It then attaches the chosen file to the current... read more

  • SMTPit_SetAuthentication

    If your mail server requires authentication (requires you to log in) before it allows you to send email, then use the SMTPit_SetAuthentication function to assign the type of authentication your mail... read more

  • SMTPit_SetBCC

    Use the SMTPit_SetBCC function to assign the "BCC" (Blind Carbon Copy) email address(es). Any email addresses you have in the BCC list will have the email sent to them, but their email will not show... read more

  • SMTPit_SetBody

    Use the SMTPit_SetBody function to set the Plain Text or HTML Body of the email. The "Body" of the email is the content of the email that the receiver will... read more

  • SMTPit_SetBodyFooter

    This unique function will allow you to have a "Footer" section in the Plain Text or HTML Body of your email. Possible uses include an email signature, a public key, an email advertisement, quotes, or... read more

  • SMTPit_SetBodyHeader

    This unique function will allow you to have a "Header" section in the Plain Text or HTML Body of your email message. Possible uses are email letterheads or personalized email messages for mass... read more

  • SMTPit_SetBodyWithFile

    You can use the SMTPit_SetBodyWithFile function to load a text file into the Plain Text or HTML Body of the... read more

  • SMTPit_SetCC

    Use the SMTPit_SetCC function to assign the "CC" (Carbon Copy) email address(es). If you have multiple email addresses and you want to set them all at once, separate each email address with a... read more

  • SMTPit_SetCharSet

    Sets the Character Set that SMTPit uses when generating the... read more

  • SMTPit_SetFrom

    Use the SMTPit_SetFrom function to assign the "From" email address. If you assign a from email address using this function, SMTPit Pro will ignore the Default From field in the Configuration Dialog.... read more

  • SMTPit_SetHost

    The Host is the domain name or IP address of the SMTP Pro mail server you are connecting to. You can assign the host in your scripts, or set up a Default Host in the Configuration Dialog. SMTPit_Send... read more

  • SMTPit_SetInlineImage

    The SMTPit_SetInlineImage function is similar to the SMTPit_SetAttachment function. This function allows you to attach a graphic image file from your hard drive or network to the current email being... read more

  • SMTPit_SetInlineImageWithDialog

    The SMTPit_SetInlineImageWithDialog function is similar to the SMTPit_SetAttachmentWithDialog function. This function presents you with a standard open file dialog that lets you choose an image file... read more

  • SMTPit_SetPriority

    This function allows you to set the "Priority" of an email. Most email clients understand the Priority setting on an email and will highlight the email as more or less important than other emails.... read more

  • SMTPit_SetReplyTo

    This function is used to set the "Reply-To" header of an email message. Most email clients will look for this email header and when a user replies to an email, the email will be sent to this email... read more

  • SMTPit_SetSubject

    Use this function to set the Subject of the email. If you assign a Subject of the email with this function, SMTPit Pro will ignore the Default Subject field in the Configuration... read more

  • SMTPit_SetTo

    Use the SMTPit_SetTo function to assign the "To" email address(es). If you have multiple email addresses and you want to set them all at once, separate each email address with a paragraph mark or, if... read more

  • SMTPit_StatusWindow

    Use this function to show a status window that displays information about what the plug-in is currently doing. When you are sending an email, the status window will show you what part of the email it... read more

  • SMTPit_StyledTextToHTML

    This function will convert styled text to HTML. In other words, you can convert a field that has styled text such as bold, underline, color, font, size, etc. to html and in effect, send HTML email... read more

  • SMTPit_VerifyEmailAddress

    You can use this function to verify the syntax of an email address to see if it "looks" correct. You can also verify the email address against its host server to see if it is valid. Note: The... read more

  • SMTPit_Version

    This function returns the current version of SMTPit Pro. This function is useful for testing whether or not the plug-in is installed and enabled. If you call this function and a question mark ("?")... read more

  • SMTPit_VersionAutoUpdate

    This function returns an Auto Update friendly Version number of SMTPit Pro. The format of this version number is always exactly 8 digits long. The first two digits represent the major version of... read more