This endpoint is used to create an audience by data file. The data file is uploaded via form-data sent in the body of the request. The audience is only successfully created if the data in the file_path corresponds with the expected format.
Specifically, the audience data must match a supported audience type. Each audience type requires a matching set of column headers in the uploaded CSV file. Valid audience types with their required corresponding header columns include:
ADDRESSES
street_number (aliases = "street_number", "street_nbr", "street_num")
route (aliases = "street_name", "street", "route")
unit_number (aliases = "unit_number", "unit_num", "unit_nbr")
city (aliases = "city", "cty")
state (aliases = "state")
postal_code (aliases = "postal_code", "zip_code", "zip", "postal", "postal_codes")
EMAIL_AND_ADDRESSES
email (aliases = "email", "email_address")
street_number (aliases = "street_number", "street_nbr", "street_num")
route (aliases = "street_name", "street", "route")
unit_number (aliases = "unit_number", "unit_num", "unit_nbr")
city (aliases = "city", "cty")
state (aliases = "state")
postal_code (aliases = "postal_code", "zip_code", "zip", "postal", postal_codes")
EMAILS
email (aliases = "email", "email_address")
POSTAL_CODES
postal_code (aliases = "postal_code", "zip_code", "zip", "postal", "postal_codes")
USER_PROFILE_SKS
user_profile_sk (aliases = "user_profile_sk", "user_id", "user_profile_id")
where aliases refer to string names which we consider equivalent to each other and are thus classified to the same column header name.
NOTE: filename must only be alphanumeric characters, underscores ('_') and be of the .csv filetype.