Adding, updating and removing customer’s mailing lists
This guide helps you to understand how to manage mailing lists of customers manually with Custobar’s api.
Custobar manages automatically mailing lists for your customers based on subscription and unsubscription events. To manage the mailing lists of your customers manually, you may use the customer data import api to set the mailing lists of a customer.
The following examples use email addresses to identify the customers. Note that multiple customers may share an email address, thus multiple customers may be updated with a single record. To identify the customers exactly, provide the individual customer’s id.
Add customers to mailing lists
To add mailing lists for a customer send an update to customer data api, with the following JSON or CSV document.
The mailing_lists
property of a customer is a list of mailing list names, that can be set, added to or removed from. To add names to the list, suffix the property with .add
, i.e. mailing_lists.add
.
JSON example
[
{ "email": "jane@example.org", "mailing_lists.add": ["vip"] },
{ "email": "joe@example.org", "mailing_lists.add": ["vip"] }
]
CSV example
email;mailing_lists.add
jane@example.com;vip
joe@example.com;vip
Set mailing lists of customers
To set the mailing lists of customers to exactly ones defined by you, update the customer’s mailing_lists
property, with the example below.
In the example, the first customer’s mailing lists will be set to “price_group_1” and “vip”, whereas the second customer’s mailing lists are set to “price_group_3”.
JSON example
[
{ "email": "jane@example.org", "mailing_lists": ["price_group_1", "vip"] },
{ "email": "joe@example.org", "mailing_lists": ["price_group_3"] }
]
CSV example
email;mailing_lists
jane@example.com;price_group_1,vip
joe@example.com;price_group_3
Remove customers from mailing lists
To remove customers from mailing lists, update the customer’s mailing_lists
property, with the example below. The example below, will remove “vip” group from the customer.
JSON example
[
{ "email": "jane@example.org", "mailing_lists.remove": ["vip"] }
]
CSV example
email;mailing_lists.remove
jane@example.com;vip
New customers and default values
If you supply an email address that does not exist in the Custobar, a new customer will be created for the address. These created customers do not have email marketing permission turned on by default and thus won’t be receiving messages sent to a mailing list.
To simultaneously to turn on the email marketing permission, set also the default value to customer’s can_email
property as shown below.
JSON example
[
{ "email": "jane@example.org", "mailing_lists.add": ["vip"], "can_email.default": true },
{ "email": "joe@example.org", "mailing_lists.add": ["vip"], "can_email.default": true }
]
CSV example
email;mailing_lists.add;can_email.default
jane@example.com;vip;true
joe@example.com;vip;true
Setting the default value for can_email
property works as follows.
If the customer exists and does not have the email marketing permission defined, set it as the imported default; otherwise leave it unchanged. If no customers exist with the supplied email address, create a new one and set the email marketing permission to the imported value.
User Guide
Main views
- How to save money on Google Ads?
- LensOnline
- Partnerimme Solteqin webinaari Love My eCom: Konversiot kaakkoon – näin saat e-shoppailijat ostamaan
- Webinar: How to utilize artificial intelligence in marketing?
- Open application
- Webinar recording: Establishing successful omni-channel customer experience by mastering customer data in retail
- Sales heat map
- Pin code for in-store interface
- In-store interface
- Cohort Analysis
- Customer page symbols
- Products view
- Events view
- Dashboard view
- Customer 360° view layout configuration
- Customers view
- Customer change history
- The new search blocks
- Sales view
Video tutorials
- Facebook Ads integration tutorial video
- Google Ads Customer Match integration tutorial video
- Email campaign video tutorial
- Email content editor video tutorial
- SMS campaign video tutorial
- Template designer video tutorial
Email campaigns
- Call to action email module
- Link an Unsubscribe page to a mailing list
- How to purchase email or SMS credits?
- UTM Tags
- Custom utm_source tags
- How to add coupon codes to your campaign
- Customer satisfaction survey
- Unsubscribe survey & report
- Email sender authentication
- IP address warmup
- Product recommendations
- Create your own template with the template designer
- How to use Custobar stickers on product images
- Creating and editing a template
- Audiences in Custobar
- Create a campaign for a fixed recipient
- Creating an email campaign action — Whole process
- Campaign statistics view
- A/B testing in Custobar
- Email campaign video tutorial
- Email content editor video tutorial
- Template designer video tutorial
Banner campaigns
- Audiences in Custobar
- Create a campaign for a fixed recipient
- Campaign statistics view
- Setting up banner campaigns
SMS campaigns
- How to purchase email or SMS credits?
- Audiences in Custobar
- Create a campaign for a fixed recipient
- Campaign statistics view
- Creating an SMS campaign action
- SMS campaign video tutorial
- Two-way SMS
External campaigns
- Facebook Ads integration tutorial video
- Facebook Ads Manager integration
- Google Ads Customer Match integration tutorial video
- Google Ads Customer Match integration
- Audiences in Custobar
- External campaign configuration for data extraction
- Create a campaign for a fixed recipient
- Creating an External Campaign Action
- Campaign statistics view
Push campaigns
- How to set up a push action
- Audiences in Custobar
- Create a campaign for a fixed recipient
- Campaign statistics view
Add-ons
- Facebook Ads Manager integration
- Google Ads Customer Match integration
- How to add coupon codes to your campaign
- Product recommendations
- How to use Custobar stickers on product images
Data integrations
Importing and updating data
- Data import file templates
- Setting up Custobar - Zapier integration
- Promoting customers
- How to send events from a website
- Deleting customers in bulk
- Adding, updating and removing customer's mailing lists
- Adding a new user to Custobar
- Updating data of multiple customers at once
Marketing and advertising integrations
- Facebook Ads integration tutorial video
- Facebook Ads Manager integration
- Google Ads Customer Match integration tutorial video
- Google Ads Customer Match integration