New_recipients

The <new_recipients> section is a container where you can choose to:

  • Add recipients directly to the XML instructions file

  • Specify a CSV file that contains the appropriate recipients

    We recommend using a CSV file instead of adding the recipients directly, to:

    • Separate recipient addresses from the campaign data

    • Avoid the overhead involved in parsing a large XML file during processing

The <new_recipients> section is:

  • A child of the Recipients section

    You can add recipients using either <new_recipients> or the Filter section. See the Recipients section for more details.

  • Positioned after the <retry /> tag (if used) within the <recipients> section of the XML instructions file

    If no <retry /> tag is used, the <new_recipients> section is the first entry within the <recipients> section.

The <new_recipients> section includes the following children:

Child Type Description Use
recipient element Add recipients directly to the XML. Choose <recipient> or <csv_file>
csv_file element Upload a CSV file containing recipients. Choose <recipient> or <csv_file>

Use

You cannot use both <recipient> and <csv_file> for the same delivery.

Regardless of whether you add recipients directly, or upload a CSV file, XMLDelivery adds the relevant data to your Contactsend user database and automatically creates the relevant filter. See Filtering and added recipients for more about how the user database is filtered to match new recipients.

Example:

    <new_recipients>
        <!-- xml recipients embedded in the xml file -->
        <recipient>
            <email>field1A</email>
            <firstname>field2A</firstname>

            ...
        </recipient>
        <recipient>
            <email>field1A</email>
            <firstname>field2A</firstname>

            ...
        </recipient>

        ...

        <!-- or a csv file -->
        <csv_file>file.csv</csv_file>
    </new_recipients>

Next page:

Recipient


Also see: