Audience Import

POST to https://api.madmimi.com/audience_members with the following parameters:

▪ Your Mad Mimi username
▪ Your Mad Mimi api_key
▪ A csv_file (which can be unstructured input)
▪ (Optional) The name of the audience_list you want to import into

Sample input

The CSV file should contain a header row that contains column names like 'email', 'first name', 'last name'. Email is the only required column. Custom columns, like the car column in the example below, can be added and then used in promotions just like any other personalization tags.

An example of a CSV file:

    email,first name,last name,car
dave@example.com,Dave,Hoover,Ford
colin@example.com,Colin,Harris,Chevy

Importing into audience lists

Audience lists are also supported in a CSV file. Simply add a column titled 'add_list' that contains the name of the list you would like the email added to.

An example:

email,first name,last name,add_list
dave@example.com,Dave,Hoover,customer
colin@example.com,Colin,Harris,investor

Removing from audience lists

By adding a 'remove_list' to your column headings in your CSV file, you can tell Mad Mimi to remove certain email addresses from particular lists.

An example:

email,first name,last name,remove_list
dave@example.com,Dave,Hoover,customer
colin@example.com,Colin,Harris,investor

Suppression

Suppression is also supported in a CSV file. Simply add a column titled 'opt_out' that contains a 1 for suppress, 0 for unsuppress and is blank for no change

An example:

email,first name,last name,opt_out
dave@example.com,Dave,Hoover,1
colin@example.com,Colin,Harris,0
john@example.com,John,Davis,

In the example, Dave would be suppressed, Colin would be unsuppressed and John would remain (un)suppressed.