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>

Use​

Use