DocsICP FilingConsole
Documentation

Create a recipient list

Updated at:
Copy as MD
Product
My Favorites

A recipient list is a list of email addresses used for sending batch emails.

Create a recipient list

  1. Log on to the Direct Mail console.

  2. In the navigation pane on the left, click Recipient Lists.

  3. In the upper-right corner of the page, click Create Recipient List. The Create Recipient List page appears.

  4. Enter a list name, alias address, and description, and then click OK to create the list.

    Note: List name and alias address

    • The list name is used to identify the list in API calls and must be unique.

    • The alias address is an email address that serves as an alias for the recipient list. This address is for identification purposes only and is not used as a parameter in API calls.

  5. Download one of the provided templates. The CSV format is recommended. Then, use a tool such as Microsoft Excel to populate the template.

    • Additional information:

    • In the EmailAddr column (Column A), enter the recipient's email address. This field cannot be empty and must not contain duplicate addresses. Otherwise, the duplicate entries are removed during the upload. Do not delete or modify this variable name.

    • UserName, Gender, and Birthday in Row 1 of Columns B, C, and D are example variable names. You can modify or add variable names to match the variables in your email template.

    • Variable names can contain only uppercase and lowercase letters (a–z, A–Z). Otherwise, an error is reported during the upload.

    • If your template does not use other variables, delete the content in Columns B, C, and D.

    • Before you upload the file, delete all content from the notes section of the template.

      Note

      You can add a maximum of 50 custom variables. The size of the custom data in a JSON-formatted string cannot exceed 6 KB. Custom variable names can contain only English letters.

      For more information, see Create a single recipient.

  6. On the Recipient Lists page, find the list that you created. In the Actions column, click Upload. The Upload File dialog box appears.

  7. Select the prepared recipient list file, and then click Open to upload it.

    • Note:

    • Recipient list files in TXT and CSV formats are supported.

    • Fields in the file must be separated by commas (,). The recipient's email address is required.

Note: You can add a maximum of 10 recipient lists. The number of email addresses in a single list is limited by your daily quota, up to a maximum of 10,000 addresses.

Recipient list example

The maximum length of UserName is 75 characters, but 50 or fewer characters are recommended. The maximum length for both Gender and Birthday is 25 characters.

Recipient Email Address {EmailAddr}

Recipient Name {UserName}

Recipient Salutation {Gender}

Recipient Birthday {Birthday}

test1***@example.net

Zhang San

Mr.

1990/1/1

test2***@example.net

Zhang San

Mr.

1990/1/1

test3***@example.net

Zhang San

Mr.

1990/1/1

test4***@example.net

Zhang San

Mr.

1990/1/1