SMTPit_SetTo

Description

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 in a field, with a return. SMTPit Pro will validate the email addresses you give it to see if they "look" like email addresses. If SMTPit Pro cannot find a valid email address, it will return an error.

SMTPit Pro considers all of the following to be "valid" email addresses:

smtpit@nowhere.com
<smtpit@nowhere.com>
SMTPit Support <smtpit@nowhere.com>
"SMTPit Support" <smptit@nowhere.com>
"Smith, John" <john@nowhere.com>
<smtpit@nowhere.com> (SMTPit Support)

The basic rule is, if you have any "human readable" name in the email address (like "SMTPit Support"), then you need angled brackets (< >) around the actual email address. This is so mail servers and mail clients can correctly identify the email address. If you have a comma in the "human readable" name, then you need to enclose it in double quotes ("") (like "Doe, John").

Return Type

Text

Format

SMTPit_SetTo ( To(s) ; SMTPit_Append )

Required Parameters

To(s)
The To Email Addresses for the email.

Optional Parameters

SMTPit_Append
Leave this in to add the(se) Email Address(es) to the current list of Addresses.

Examples

Example 1

Code:

SMTPit_SetTo("SMTPit Support <smtpit@nowhere.com>")

Result:

Sets the To email to "SMTPit Support <smtpit@nowhere.com>".

Example 2

Code:

SMTPit_SetTo("smtpit@nowhere.com¶pop3it@nowhere.com")

Result:

Sets the To addresses to "smtpit@nowhere.com" and "pop3it@nowhere.com".

Example 3

Code:

SMTPit_SetTo("sales@nowhere.com"; SMTPit_Append )

Result:

Appends the address "sales@nowhere.com" to any To addresses that have already been set.