Address book and Blacklist FAQ

What are Address Book and Blacklist?

Address books and Blacklist are lists of contacts. They are .csv files containing one contact per line while the first line is used for data headers. Both are operated using similar API methods and formatted the same way. 

Blacklists are generated using your address book: recipients who responded with an unsubscribe input (stop message or press 0) are added to the blacklist associated with the campaign.

Blacklists are dynamically updated by SENDR or the API. If you choose to handle unsubscription with your campaigns, prospects who responded with STOP (SMS) or pressed 0 (voice) will be added to the blacklist of the campaign.

Are there any limits to the number of address books and blacklists I can upload?

There are no limits to the number of address books and blacklists you can have. You can upload address books of any size up to 8 Mb.

Interacting with address books and blacklists with SENDR

You can find your address books and blacklists on the relevant tab in SENDR. You can view, rename or delete them straight from the app. If you wish to edit a blacklist or an addressbook, you need to download the csv/xls file, edit it and upload it back.

Variables set up in the addressbook (header row) can be used in your campaigns' messages, be it SMS text or Text-to-Speech prompt.

Interacting with address books and blacklists using the API

You can find an overview of the available API methods to create and manage address books and blacklists in our documentation:

Address books and blacklists are identified by a unique 8 alphanumeric character hash code that is required as a parameter to edit, delete, preview or append them.

How can I find my address book/blacklist hash IDs?

Using the API, you can find your address book and blacklist IDs using the search methods: sendr/10/addressbook.search method (doc) and sendr/10/blacklist.search method (doc).

You can fetch a list of your address books and blacklists using these methods with empty filters and options arrays as parameters. Check the API FAQ for more details.

Was this article helpful?
0 out of 0 found this helpful

Comments

0 comments

Please sign in to leave a comment.