Wondering how to access and store lead data? Check our short guide to the Lead Stash settings for more information.
Lead Stash is an internal data storage system that allows you to store and access lead data.
To configure Lead Stash settings, go to the System Management > Products section, choose the product, and click the “Settings” button in the “Action” column.
On the Product setup page, go to the “Lead Stash Settings” tab. It contains four sub-tabs:
For preset Products, Lead Stash is usually not configured. If either “Email” or “Phone Number” fields exist in the Product, the system will show you the corresponding message.
Click the “Enable Lead Stash” button to generate an internal storage system for the corresponding Product.
Incoming Leads
The "Incoming Leads" sub-tab allows you to configure the Lead Stash for a Product.
The Data Lookup Settings block contains the following options:
- Perform Data Lookup: Select the system behavior when the lead data is found and pulled from the Lead Stash:
- Disable: When disabled, it won’t allow you to pull data from the lead stash.
- Store Lead Stash Log Only: Pulls data from the lead stash and displays it in the Lead Info.
- Fill Empty Lead Data Fields: Pulls the lead data from the lead stash, compares it with the already posted data, and fills in the empty fields.
- Overwrite Lead Body: Rewrites the lead data with the data pulled from the lead stash.
- Limit the lookup in Lead Stash within the past: Switch the toggle to enable/disable the input information updating in the Lead Stash within selected timeframes.
Note: You can set a time when new data will be created at the Lead Stash instead of overwriting the old one. - Protect lookup field: Switch the "ON/OFF" toggle to enable or disable the lookup field protection. If enabled, when replacing lead parameters with data from the lead stash (Perform Data Lookup = Overwrite Lead Body), key fields (Email for LMS, Phone for Call Logic products) will not be overwritten.
The Data Storage Settings block contains the following options:
- Store lead data in Lead Stash: Select the "Active" option to enable the lead data storing in the Lead Stash.
- Store lead data in Lead Stash only for these statuses: Select the lead status(es) of the leads (Sold / Reject / Test / New / Fraud Reject / Post Error / Offer Received) to store data in the Lead Stash.
- Store data in Lead Stash on Ping (for Ping-Post Products only): Select the (Yes / No / If Data Not Found) option to enable/disable data storing on Ping.
Click the “Save” button to apply settings.
API Access
The “API Access” sub-tab allows you to manage access to the Lead Stash through the API.
The API Settings block contains the following options:
- Enable storing data using API: Switch the toggle to the “ON” position to enable lead data recording to the Lead Stash through the API, and vice versa.
- Enable data lookup using API: Switch the toggle to the “ON” position to enable the lead data search and pull from the Lead Stash through the API, and vice versa.
Click the “Save” button to complete the settings.
To generate a new API Key, click the “Add New API Key” button.
Note: If both options are disabled, you can not add the new keys or edit the existing ones (but you can still view the list of the keys).
If one option is disabled, the system will display the following message in the API documentation.
Then, fill in the following fields in the “Add New API Key” pop-up window:
- Name: Enter the API name.
- Nickname: Select the user who is generating an API Key.
Note: The Lead Stash option is available only for registered users.
- Get Data: Select the type of access level to the Lead Stash data:
- Disabled: Do not provide access to the Lead Stash data.
- Full Data: Give access to all Lead Stash data.
- Part Data: Give access to all Lead Stash data except protected fields (protected fields are encrypted fields with sensitive data by default).
- Existence Check: Do not provide access to the Lead Stash data. Display only lead presence in the Lead Stash.
- Set Data: Enable/Disable data recording to the Lead Stash through the API.
- Active: Enable data recording.
- Disabled: Disable data recording.
- Rate Limit: Select the limit to record/pull data to/from the Lead Stash through the API:
- Disabled: Disable the Rate Limit.
- High Rate - 5000/minute, 40000/10 minutes: number of requests per minute.
- Medium Rate - 2500/minute, 20000/10 minutes: number of requests per minute.
- Low Rate: - 1000/minute, 8000/10 minutes: number of requests per minute.
- Tiny Rate: - 100/minute, 800/10 minutes: number of requests per minute.
- Per minute: - 5/minute, 40/10 minutes: number of requests per minute.
To check the API documentation, click the “Doc” button in the “Action” column.
To view the Proxy servers list, click the “Proxy” button in the “Action” column.
Click the “Change API password” button in the “Action” column to change the API password.
Click the “Edit” button in the “Action” column to edit the API key.
Click the “Delete” button in the “Action” column to delete the API key.
Proxy Settings
The “Proxy Settings” sub-tab allows you to configure how data is searched in the Lead Stash, add other Phonexa Lead Stash proxies, and set up the priority of the look-up.
To add a new proxy, click the “Add New Proxy” button. Fill in the following fields in the pop-up window:
- Proxy Type: Select the proxy type (Phonexa Lead Stash (new) / Data by Lead Id).
- Name: Enter the name of the proxy record.
- URL: Enter the proxy URL.
- API ID: Enter the API identifier.
- API Key: Enter the API key.
Click the “Add” button to save.
Read more information about the API configuration in the API Access article.
By default, the search is implemented only within the Lead Stash (self) of the product on which it is configured. To change the order of access to proxies, use the drag-and-drop function.
Click the “Edit” button to configure the proxy.
Click the “Delete” button to delete the proxy.
According to the set priority, if the lead was not found on the first lead stash (and in cases when no data was found in 10 seconds and API returned with an empty result), the search would continue on the next one.
Click the “Save” button to apply changes.
Incoming Data Modifiers
The “Incoming Data Modifiers” sub-tab allows you to add or remove country codes on phone numbers the system is going to put in the Lead Stash search keys.
The “Search Key Phone Number Normalizer” block contains the following options:
- Status: Switch the toggle to the “On” position to enable this option.
- Fields to process: Select the name of the fields to process.
- Enabled for the following publishers only: Select the names of the Publishers for whom this option will be available.
Note: If that field is not empty, the modifier will be applied only to the leads of the selected Publishers. - Disabled for the following publishers: Select the names of the Publishers for whom this option will be disabled.
Note: If that field is not empty, the modifier will not be applied to the leads of the selected Publishers. - Country code: Select the country code.
- Strategy: Select the strategy (Save both combinations with and without country code / Add country code if not added / Remove country code if present).
Click the “Save” button to apply settings.
Data Filters
The Data Filters tab allows you to set rules that restrict data output from Lead Stash when specific field values do not meet the defined conditions. It displays a list of existing filters with options to add, edit, delete, or reorder them. This is especially useful when you want to restrict the exposure of sensitive or valuable lead information unless certain criteria are met. Note: This tab is enabled only on demand.
The Lead Stash Filters block contains the following information:
- Status: The current status of the rule (Active / Paused).
- Name: The name of the rule.
- Run Type: The run type of the rule:
- Lead Processing: Runs when the lead is being processed.
- API: Runs on the API of the lead stash.
- Filter Type: The type of filter:
- iClear Service: This type of filter enables you to filter leads for which the system will provide or restrict data output from the Lead Stash. Use case: If a lead passes the selected iClear service but comes from Andorra, and the rule is configured to block Lead Stash output for leads from this country, the system will suppress the data. Note: The lead will still be processed; it just won’t have data pulled from the Lead Stash.
- PL/DNPL: This type of filter controls data output based on whether the lead is on a Present List or Do Not Present List (DNPL). You can choose to allow output depending on the list the lead matches. Use case: You may choose to output the Lead Stash data if the lead is on a Present List or Do Not Present List.
- Config: The configuration of the rule.
- Cost: The rule cost per ping.
To add a new PL/DNPL lead stash filter, click the “Add Filter” button, select the PL/DNPL Filter option, and fill in the required fields:
- Name: Enter the name of the rule.
- Product Field: Select the Product field.
- Product Field Manual: Enter the Product field manually.
- Value Modifiers: Select the value modifiers of the rule (Trim Spaces, Convert to integer, Lowercase, Uppercase).
- Run Type: Select the run type of the rule:
- Lead Processing: Runs when the lead is being processed.
- API: Runs on the API of the lead stash.
- PL/DNPL Type: Select the PL/DNPL type:
- Internal DNPL/PL: Allows you to select the PL/DNPL list from the instance.
- Phonexa DNPL/PL API: Allows you to select the Phonexa PL/DNPL (the system will offer you to enter the List ID and credentials in a pop-up window). Note: You should have the PL/DNPL list’s API access enabled.
- DNPL/PL List: Select the PL/DNPL list. Note: This field appears only for selected Internal DNPL/PL type.
- DNPL/PL List ID: Enter the DNPL/PL list identification number. Note: This field appears only for selected Internal Phonexa DNPL/PL API type.
- URL: Enter the web address of the list. Note: This field appears only for selected Internal Phonexa DNPL/PL API type.
- API Key: Enter the API key. Note: This field appears only for selected Internal Phonexa DNPL/PL API type.
- Timeout: Enter the timeout number in seconds. Note: This field appears only for selected Internal Phonexa DNPL/PL API type.
- Action on ping failure: Select the action on the ping failure (Do not get data / Get data). Note: This field appears only for selected Internal Phonexa DNPL/PL API type.
Click the “Add” button to finish.
To add a new iClear Service lead stash filter, click the “Add Filter” button, select the iClear Service Filter option, and fill in the required fields:
Select Third Party Service: Select the third-party service (Ip Scoring). Note: The IP Scoring third-party service allows you to perform real-time validation of the lead IP address and receive a fraud score based on 25 risk analysis data points. The service scores user data based on an IP address, device, email address, and phone number.
- Name: Enter the name of the rule.
- Run Type: Select the run type of the rule:
- Lead Processing: Runs when the lead is being processed.
- API: Runs on the API of the lead stash.
- Value Modifiers: Select the value modifiers of the rule (Trim Spaces, Convert to integer, Lowercase, Uppercase).
The rest of the fields may differ if you select another device; for the details, please refer to the corresponding iClear services articles.
Click the “Add” button to finish.
To temporarily stop the rule, click the “Pause” button in the “Actions” column. Confirm your intention in the pop-up window.
To specify the rule launch order, click the top-pointed arrow button and the bottom-pointed arrow button. Click the “Save Order” button to apply changes.
To edit the rule, click the “Configure” button. In a pop-up window, click the “Edit” button to proceed.
To delete the rule, click the “Delete” button in the “Actions” column. Confirm your intention in the pop-up window.