---
title: How To Create A Contact List and Set up API Access
description: In this section, you can find detailed instructions on creating contact lists and setting up API access to update contact lists through the API.
---
[Skip to content](https://support.phonexa.com/how-to-create-a-contact-list-and-set-up-api-access#main-content)
[](https://support.phonexa.com/?hsLang=en)
Open main navigation
Close main navigation
- [➜\]](https://phonexa.com/)
[➜\]](https://phonexa.com/?hsLang=en)
Phonexa Support Center
- There are no suggestions because the search field is empty.
1. [Knowledge Base](https://support.phonexa.com/?hsLang=en)
2. [E-Delivery](https://support.phonexa.com/e-delivery?hsLang=en)
3. [List Management](https://support.phonexa.com/e-delivery?hsLang=en#list-management)
# How To Create A Contact List and Set up API Access
## In this section, you can find detailed instructions on creating contact lists and setting up API access to update contact lists through the API.
To create a contact list with API documentation, go to the **List Management \> Contact Lists** section and click the **“Add Contact List**” button.
[](https://phonexa-4703e840ef03.intercom-attachments-7.com/i/o/421411439/f2300504c3d7d4ef4b43c8a2/d3h6YplBV12I8hyjgzLXh56qYFhKz5CyXhKkHJYgoicKzfEp41Kwes2kxOq2s9sNA6hSZ-Rq5MrTnfHKjCwZF1dfOIO_RrkPy0tlxxjl-vzPxx6MI3O28ha4yAjgotd5jQU7odL6)
In the Add Contact List pop-up window, fill in the following fields:
- **Name:** Enter the name of the contact list.
- **Select Folder**: Select the related folder for the list.
- **Create New Folder**: Enter the name of the new folder.
- **Tags:** Select the list tag.
- **Description:** Enter an additional description for the contact list.
- **Enable API?:** Check the box to enable the API for the contact list, and generate API Documentation that contains the information on how to add a contact to the list through the API.
Click the **“Add”** button to complete the action.
[](https://phonexa-4703e840ef03.intercom-attachments-7.com/i/o/421411446/d623e74afb3e1364b01da7e3/uUOf6tMU1IuWm7bMs-EKVa58zJXNNZSyyToghUKBNCg4PLYZqZdYEPoSXIWoIxr_oRa2DAnwc7kzhGJOSRbA2HdvVU_3_MgD1dvsKborfeyLyaSQ28U0NioP_v15LFcI-lbCAUb8)
When the **“Enable API”** checkbox is enabled, it automatically generates API documentation for the contact list. To check the documentation, click the **“API Documentation”** button in the **“API**” column.
[](https://phonexa-4703e840ef03.intercom-attachments-7.com/i/o/421411453/c97b1886268531f3abce48fe/maO64m3MU-XCmOCA8hNPhZpJvhlNbHPP9XUEjcd72KJVh2iHs7-vLc_9UrIuU5YL3s2miiVlzCw66PtO3GtCEgD9a4xtlCFOoupvlrlyYVH0N4s8jasfixdUtXBlSzCrmsqGghvf)
To set up the API access for the contact list, you will need the API key and ID of the list. This information can be found in the **“Request Fields”** section. The API Documentation key is displayed in the **“authKey”** field, and the ID number of the list - in the **“list\_id”** field. These credentials could be used when setting up the E-Delivery integration for LMS or Call Logic.
*Note: E-delivery integration could be used for a silent campaign for LMS and Call Logic. Read more about the silent Campaign setup process in this Knowledge Base [article](https://support.phonexa.com/silent-campaigns?hsLang=en).*
To add and manage the Contacts for the particular list, click the **“Manage”** button in the **“Action”** column.
[](https://phonexa-4703e840ef03.intercom-attachments-7.com/i/o/421411469/60f88d9c7bdd83a46e379f7c/RNN3LmUSeM4eJlIhQXRzqcyWel9VZhdJ_ja__c2UX8aCknlSS6g3wjdWNIfX0ZGUn076gXhrNR9PgRFs2tPsN6-GrdcqKK1mwxg9hR6zfd76mgVWXiaVJmOzErpX0GnJPfwFgOF4)
To add an existing Contact to the list, click the **“Manage”** button in the **“Actions”** column and click the **“Add Contact”** button.
[](https://phonexa-4703e840ef03.intercom-attachments-7.com/i/o/421411482/28b4f640326e68a2b952e54f/h0fOlG5Uv0kykF-HCoTYHQJU_hhCcl_2wUjYVKYFUk3poPTkiIfGVkJrNXA8BzmfneX8pZZwPxQlMg_gBpCcP0xJrnUYCZReuiHpYGQL_1e8eGPkkKixLAWbDcP_ffrFu7qAyRzi)
Select the contact that you would like to add from the list in the **“Add Contact**” pop-up window and click the **“Add New”** contact button in the **“Action”** column. Please note that only contacts previously added in the **“All Contacts”** section are available for selection. *Read more about the **“All Contacts”** section in this Knowledge Base [article](https://6013559.hs-sites.com/all-contacts-1?hsLang=en).*
Click the **“Save”** button to complete the action.
[](https://phonexa-4703e840ef03.intercom-attachments-7.com/i/o/421411499/b77f10830fcf14a0c8e992be/0aDPutndJV38Azet-3Pxs9aEsZiKqyVDHWdaDYjgYD1_krSRvzBj7ecWoLDaMBrJ6t62T3vwVpPmQHEtr7lUXdhoP56VmLARWv-miZW-kokyYjdnomFP2Pgjqgff6zPId8_RwMke)
You can narrow down the search results by using the following filters:
- **Contact**
- **First Name:** Enter the first name of the contact record.
- **Last Name**: Enter the last name of the contact record.
- **State:** Enter the state of the contact.
- **Zip:** Enter the Zip code of the contact.
- **Email**
- **Email:** Enter the email address of the contact record.
- **Status:** Select the current status of the contact (Active, Inactive, Bounced, Suppressed).
- **Email Domain:** Select the domain of the contact’s email address.
- **Phone**
- **Phone:** Enter the phone number of the contact record.
- **Status:** Select the current status of the contact’s phone number (Active, Inactive, Suppressed).
Click the **“Search”** button to generate the list of the contact according to the selected filters.
To add all your contacts to the list click the **“Add All By Filter”** button.
Once you add contacts to the list, the list will be displayed in the main block of the **Contact List: Manage** section. To view the section, click the **“Manage”** button for the selected list.
*Read more about the **Contact List: Manage** section in this Knowledge Base [article](https://support.phonexa.com/contacts-lists?hsLang=en).*
[ ](https://phonexa-4703e840ef03.intercom-attachments-7.com/i/o/421411508/436c7443975dd4362d4772f0/BbPPWvu0fty3r6Uy3HDc-8-AprIGTFSCASRMEOMDAojBCuS3W1-KckZjKW0ZQlR1iSLliDP7BxBgLf_LwcbbquYp4kGIJr8HqcrD1bl2f3ueLcFH8nLH2qYyEiy5EdeBmnsZdV8R)
- [General information](https://support.phonexa.com/general-information?hsLang=en#main-content)
- [Account Settings](https://support.phonexa.com/general-information?hsLang=en#account-settings)
- [Security Settings](https://support.phonexa.com/general-information?hsLang=en#security-settings)
- [Users](https://support.phonexa.com/general-information?hsLang=en#users)
- [System Customization](https://support.phonexa.com/general-information?hsLang=en#system-customization)
- [Project Customization](https://support.phonexa.com/general-information?hsLang=en#project-customization)
- [Product Customization](https://support.phonexa.com/general-information?hsLang=en#product-customization)
- [System Management](https://support.phonexa.com/general-information?hsLang=en#system-management)
- [Support](https://support.phonexa.com/general-information?hsLang=en#support)
- [LMS Sync & Call Logic](https://support.phonexa.com/lms-sync-call-logic?hsLang=en#main-content)
- [Extra Features](https://support.phonexa.com/lms-sync-call-logic?hsLang=en#extra-features)
- [Publisher Configuration](https://support.phonexa.com/lms-sync-call-logic?hsLang=en#publisher-configuration)
- [Client Management](https://support.phonexa.com/lms-sync-call-logic?hsLang=en#client-management)
- [System Logs](https://support.phonexa.com/lms-sync-call-logic?hsLang=en#system-logs)
- [Documents And References](https://support.phonexa.com/lms-sync-call-logic?hsLang=en#documents-and-references)
- [Reports and Analytics](https://support.phonexa.com/lms-sync-call-logic?hsLang=en#reports-and-analytics)
- [Publisher management](https://support.phonexa.com/lms-sync-call-logic?hsLang=en#publisher-management)
- [Call Logic Customization](https://support.phonexa.com/lms-sync-call-logic?hsLang=en#call-logic-customization)
- [Campaign Configuration](https://support.phonexa.com/lms-sync-call-logic?hsLang=en#campaign-configuration)
- [Feed CMS](https://support.phonexa.com/lms-sync-call-logic?hsLang=en#feed-cms)
- [Event Tracking](https://support.phonexa.com/lms-sync-call-logic?hsLang=en#event-tracking)
- [iClear](https://support.phonexa.com/lms-sync-call-logic?hsLang=en#iclear)
- [E-Delivery](https://support.phonexa.com/e-delivery?hsLang=en#main-content)
- [List Management](https://support.phonexa.com/e-delivery?hsLang=en#list-management)
- [Email Campaigns](https://support.phonexa.com/e-delivery?hsLang=en#email-campaigns)
- [SMS Campaigns](https://support.phonexa.com/e-delivery?hsLang=en#sms-campaigns)
- [Reports](https://support.phonexa.com/e-delivery?hsLang=en#reports)
- [Suppression Management](https://support.phonexa.com/e-delivery?hsLang=en#suppression-management)
- [Books360](https://support.phonexa.com/books360?hsLang=en#main-content)
- [Books 360 Integration](https://support.phonexa.com/books360?hsLang=en#books-360-integration)
- [Vendor Management](https://support.phonexa.com/books360?hsLang=en#vendor-management)
- [Account](https://support.phonexa.com/books360?hsLang=en#account)
- [Customer Management](https://support.phonexa.com/books360?hsLang=en#customer-management)
- [Opt-Intel](https://support.phonexa.com/opt-intel?hsLang=en#main-content)
- [List Management](https://support.phonexa.com/opt-intel?hsLang=en#list-management)
- [All Reports](https://support.phonexa.com/opt-intel?hsLang=en#all-reports)
- [Mailers](https://support.phonexa.com/opt-intel?hsLang=en#mailers)
- [Campaigns](https://support.phonexa.com/opt-intel?hsLang=en#campaigns)
- [System Management](https://support.phonexa.com/opt-intel?hsLang=en#system-management)
- [HitMetrix](https://support.phonexa.com/hitmetrix?hsLang=en#main-content)
- [Analytics](https://support.phonexa.com/hitmetrix?hsLang=en#analytics)
- [Heatmaps](https://support.phonexa.com/hitmetrix?hsLang=en#heatmaps)
- [System Management](https://support.phonexa.com/hitmetrix?hsLang=en#system-management)
- [Lynx](https://support.phonexa.com/lynx?hsLang=en#main-content)
- [Offers](https://support.phonexa.com/lynx?hsLang=en#offers)
- [LYNX Reports](https://support.phonexa.com/lynx?hsLang=en#lynx-reports)
- [Advertisers](https://support.phonexa.com/lynx?hsLang=en#advertisers)
- [Affiliates](https://support.phonexa.com/lynx?hsLang=en#affiliates)
- [Account Settings](https://support.phonexa.com/lynx?hsLang=en#account-settings)
- [Cloud PBX](https://support.phonexa.com/cloud-pbx?hsLang=en)
[](https://phonexa.com/?hsLang=en)
Phonexa Knowledge Base
Copyright © 2026, Phonexa