Send subscription feed via SFTP server

A subscription feed file gives you a way to easily communicate opt-in and opt-out email lists to Bazaarvoice, and you do not have to implement the Notifications API to perform these bulk actions. When you subscribe consumers, they will receive Ratings & Reviews notifications (of all types). Similarly, when you unsubscribe consumers, they will no longer receive notifications of any type.

Note: If personally identifiable information (PII) encryption is a concern, use the encrypted single-email Notifications Subscription API endpoint Opens in new tab.

You can subscribe or unsubscribe a list of your consumers from notifications by creating a subscription feed:

  1. Create a feed file. You can create a text (TXT) file or a comma-separated value (CSV) file. In both cases, include one email address in each line in the file. The format of the file is as follows: 
    email_address1, 

    
email_address2, 

    
email_address3, 

    
email_address4, 

    
...

    Note: You can include up to 100,000 email addresses in a feed file.

  2. Upload the feed file to the staging or production SFTP server, as follows:

    • To subscribe email addresses to Ratings & Reviews notifications, upload the file to the /subscriptions/sub folder on the server.
    • To unsubscribe email addresses, upload the file to the /subscriptions/unsub folder.
      • If your data is hosted in the United States (US), use the following URLs:
        • Staging server—sftp-stg.bazaarvoice.com
        • Production server—sftp.bazaarvoice.com
      • If your data is hosted in Europe (EU), use the following URLs:
        • Staging server—sftp7-stg.bazaarvoice.com
        • Production server—sftp7.bazaarvoice.com

      Be sure to connect to SFTP using port 22. Contact Bazaarvoice Support if you do not know your SFTP credentials or where your data is hosted.

      Upload the feed file to Bazaarvoice by 12 AM Central Time (CST: UTC-6 or CDT: UTC-5), which is when Bazaarvoice automatically begins importing feeds.

  3. The system checks the uploaded file for correct format and structure.

  4. The system validates the email list by:

    • Ensuring each email address is correctly structured.

    • Verifying that each email domain is valid.

    • Identifying and removing duplicate entries.

  5. Valid, unique email addresses are added to the unsubscribe list and these will be excluded from future communication.

Provide feedback button