List Tools - Online Help | Zoho Campaigns

List Tools

Use List Key for API

To access list management API methods, you need a mandatory parameter "listkey". The listkey represents the mailing list you're trying to access. This purpose of this key is to add contacts to a mailing list and is used to access the mailing list using API.

To view the list key for a list:

  1. From the Navigation toolbar, choose Contacts and select Manage Lists.
  2. Click on the Mailing List, you wish to view the list key.
  3. Click the Setup subtab.
  4. Copy the List key.
    list key

Webhooks

Zoho Campaigns introduce webhooks as a service that lets you collect information about the campaigns you send and also about the contacts in your lists. Zoho Campaigns provides two types of webhooks:
  • Contacts Webhook: This webhook allows you to keep track of contacts activities in your mailing lists such as subscribes, unsubscribes, and bounces.
  • Campaign Webhook: This webhook allows you to keep track of your campaigns' status from the time of campaign creation to delivery to its recipient.

Consider the following example. Steve has to send an important campaign to a specific list of contacts and generate certain insights from his campaign. There are three tasks that Steve needs to perform in order to generate data:

  1. Keep track of the campaign to make sure the campaign is sent successfully
  2. Make sure the campaign is sent to all the contacts in the list
  3. Identify if any contacts have left or newly joined the list

These are multiple tasks that usually take time if performed manually. Webhooks automates the manual tasks and sends you periodic updates of information in the event of the above actions taking place. So Steve can simply setup a URL in his application that would collect all the data he needs and notify him with the updated information.

Associate a Webhook

At some point, you may need to collect information across various lists of contacts and campaigns in your account. This can be accomplished by associating a webhook from one list to the webhooks of another list. You can also create new webhooks for the same list and associate them to the existing webhook to get more information.
To associate a contact or campaign webhook follow the steps below:
  1. From the Navigation toolbar, choose Contacts.
  2. Select Manage Lists and select the list for which you want to add a webhook.
  3. Click the More tab and select Webhooks.
  4. Click Associate.
  5. In the Associate Webhook pop up, fill in the following information:
    • Select an existing webhook of another list or add a new webhook.
    • Select the action to be notified.
    • Select who should perform those actions.
  6. Click Done.

Disconnect a Webhook

You can disconnect a webhook connection from a specific list. However, the webhook will still exist in the webhook list page. There are two ways to disconnect a webhook:
  1. From the Navigation toolbar, choose Contacts.
  2. Select Manage Lists and select the list that you want to disconnect a webhook from.
  3. Click the More tab and select Webhooks.
  4. Locate the webhook you want to disconnect from the list and click the Disconnect icon on the top-right corner.disconnect icon

Alternatively:

  1. From the Navigation toolbar, choose Contacts.
  2. Select Manage Lists and select the list from which you want to disconnect a webhook.
  3. Click the More tab and select Webhooks.
  4. Locate the webhook you want to disconnect from the list and click the Reports icon.
  5. Click the View Details icon in the top-right corner and click the Disconnect icon.

Delete a Webhook

You can delete a webhook from a list and its associated lists in the Settings page. It will be removed from the list of webhooks in the Settings page.
  1. From the Navigation toolbar, choose Settings and select Webhooks.
  2. Locate the webhook you want to delete and select it.
  3. Click the Delete icon on the top-right corner of the details page.delete webhook icon

Reports

This section lets you view information about a webhook. You can Filter to view all or only failed or successful webhooks invoked in your lists. There are two ways to view reports:
  1. From the Navigation toolbar, choose Contacts, select Manage Lists.
  2. Select the list that you want to view the webhook reports for.
  3. Click the More tab and select Webhooks.
  4. Locate the webhook and click the Reports icon in the top-right corner.

Alternatively:

  1. From the Navigation toolbar, choose Settings and select Webhooks.
  2. Locate the webhook that you want to view logs for and select it.
  3. Click the Reports icon on the far right corner of the details page.

View Webhook Details

Webhook details let you view all the information affiliated with a webhook. You can edit a webhook, view reports and disconnect a webhook on this page. There are two places where you can view webhook details:
  1. From the Navigation toolbar, choose Contacts.
  2. Select Manage Lists and select the list for which you want to view the webhook logs.
  3. Click the More tab and select Webhooks.
  4. Locate the webhook and click the Reports icon on the top-right corner.
  5. Click the View Details icon on the top-right corner of the reports page to view webhook details.

Alternatively:

  1. From the Navigation toolbar, choose Settings and select Webhooks.
  2. From the list of webhooks displayed, click on the webhook for which you want to view details.

    Zoho CRM Training Programs

    Learn how to use the best tools for sales force automation and better customer engagement from Zoho's implementation specialists.

    Zoho CRM Training
      Redefine the way you work
      with Zoho Workplace

        Zoho DataPrep Personalized Demo

        If you'd like a personalized walk-through of our data preparation tool, please request a demo and we'll be happy to show you how to get the best out of Zoho DataPrep.

        Zoho CRM Training

          Create, share, and deliver

          beautiful slides from anywhere.

          Get Started Now


            Get started with Zoho Sign

            in a few quick steps!

            Download Help Guide





                        Still can't find what you're looking for?

                        Write to us:  support@zohoforms.com


                              




                            

                          Zoho Marketing Automation

                            Zoho Sheet Resources

                             




                                Zoho Forms Resources


                                  Secure your business
                                  communication with Zoho Mail


                                  Mail on the move with
                                  Zoho Mail mobile application

                                    Stay on top of your schedule
                                    at all times


                                    Carry your calendar with you
                                    Anytime, anywhere




                                          Zoho Sign Resources

                                            Sign, Paperless!

                                            Sign and send business documents on the go!

                                            Get Started Now


                                                Zoho SalesIQ Resources



                                                    Zoho TeamInbox Resources



                                                            Zoho DataPrep Resources



                                                              Zoho DataPrep Demo

                                                              Get a personalized demo or POC

                                                              REGISTER NOW


                                                                Design. Discuss. Deliver.

                                                                Create visually engaging stories with Zoho Show.

                                                                Get Started Now











                                                                                      • Related Articles

                                                                                      • Mailing list management

                                                                                        We have recently updated Topics in Zoho Campaigns. Please click here for the updated help document. List management is a macro level to deal with contacts and take actions on them at your convenience. This provides a detail view of contacts with ...
                                                                                      • Mailing List Pruning

                                                                                        The success of an email campaign vastly depends on having interested and engaging contacts in the mailing list. Marketers spend time and money to keep their mailing lists hygienic as old and dirty mailing list can directly affect email engagement and ...
                                                                                      • What is a List key?

                                                                                        List key is used to add contacts to a mailing list via API method. It is used as an authentication parameter and represents the mailing list you're trying to access.
                                                                                      • What if I must add a group address to my mailing list?

                                                                                        Email addresses that start with admin@, info@ and support@ are called role/group addresses. They’re created to share a mailbox with a group of people. Usually, these email addresses will not be used to receive marketing emails. If you send emails to ...
                                                                                      • SMS Campaigns Sender Address

                                                                                         In Zoho Campaigns, we support one kind of sender address format when you use our in-built SMS gateway, Long code  We will support short codes and alphanumeric codes shortly when we support a few more countries. Let's explore this sender address ...
                                                                                      Wherever you are is as good as
                                                                                      your workplace

                                                                                        Resources

                                                                                        Videos

                                                                                        Watch comprehensive videos on features and other important topics that will help you master Zoho CRM.



                                                                                        eBooks

                                                                                        Download free eBooks and access a range of topics to get deeper insight on successfully using Zoho CRM.



                                                                                        Webinars

                                                                                        Sign up for our webinars and learn the Zoho CRM basics, from customization to sales force automation and more.



                                                                                        CRM Tips

                                                                                        Make the most of Zoho CRM with these useful tips.



                                                                                          Zoho Show Resources