Amazon Fraud Detector is no longer open to new customers as of November 7, 2025. For capabilities similar to Amazon Fraud Detector, explore Amazon SageMaker, AutoGluon, and AWS WAF.
# Lists
A list is a set of input data for a variable in your event dataset. You use the input data in a rule that’s associated with your detector. A rule is a condition that tells Amazon Fraud Detector how to interpret input data during a fraud prediction. For example, you can create a list of IP addresses and then create a rule to deny access if a specific IP address is in the list. Rules that use lists are expressed in the `$ip_address_value` in `@list_name` format.
With Amazon Fraud Detector, you can manage a list by adding or removing data without needing to update an associated rule. A rule associated with your list automatically incorporates newly added or removed data.
A list can contain up to 100,000 unique entries and each entry can be up to 320 characters long. Every list you use in a rule is, by default, associated with Amazon Fraud Detector’s [Variable types](variables.md#variable-types) FREE\$1FORM\$1TEXT. You can assign a variable type to your list at any time. You can use up to 3 lists in a rule.
You can create a list, add entries to the list, delete a list, or delete one or more entries in the list, or assign a variable type to your list in the Amazon Fraud Detector console, using the API, using the AWS CLI, or using the AWS SDK.
# Create a list
You can create a list containing input data (entries) of a variable in your event dataset and use the list in rule expression. The entries in the list can be managed dynamically without updating the rule that is using the list.
To create a list, you must first specify a name and then optionally associate the list with a [Variable types](variables.md#variable-types) supported by Amazon Fraud Detector. By default, Amazon Fraud Detector assumes the list to be of FREE\$1FORM\$1TEXT variable type.
You can create a list in the Amazon Fraud Detector console, using the API, using the AWS CLI, or using the AWS SDK.
## Create list using the Amazon Fraud Detector console
**To create a list**
1. Open the [AWS Management Console](https://console.aws.amazon.com) and sign in to your account. Navigate to Amazon Fraud Detector.
1. In the left navigation pane, choose **Lists**.
1. Under **Lists** details
1. In the **List name**, enter a name for your list.
1. In the **Description**, optionally, enter a description.
1. (Optional) In the **Variable type**, select a variable type for your list.
**Important**
If your list contains IP addresses, make sure to select **IP\$1ADDRESS** as the variable type. If you don’t select a variable type, Amazon Fraud Detector assumes the list to be of **FREE\$1FORM\$1TEXT** variable type.
1. In the **Add list data**, add list entries, one entry in each line. You can also copy and paste entries from a spreadsheet.
**Note**
Make sure that the entries aren’t separated using a comma and are unique in the list. If two identical entries are entered, only one will be added.
1. Choose **Create**.
## Create list using the AWS SDK for Python (Boto3)
You create a list by specifying a list name. You can optionally provide a description, associate a variable type, or add entries to your list when you are creating a list. Or, you can update the list later on by adding entries or a description. You can assign a variable type to the list later if you haven't assigned it when at the time of list creation. Variable type of a list cannot be changed after it is assigned.
**Important**
If your list contains IP addresses, make sure to assign **IP\$1ADDRESS** as the variable type. If you don’t assign a variable type, Amazon Fraud Detector assumes the list to be of **FREE\$1FORM\$1TEXT** variable type.
The following example uses [CreateList](https://docs.aws.amazon.com//frauddetector/latest/api/API_CreateList.html) API operation to create an `allow_email_ids` list by providing a description, a variable type, and by adding four list entries.
```
import boto3
fraudDetector = boto3.client('frauddetector')
fraudDetector.create_list (
name = 'allow_email_ids',
description = 'legitimate email_ids'
variableType = 'EMAIL_ADDRESS',
elements = ['emailId _1', 'emailId_2', 'emailId_3','emailId_4']
)
```
# Add entries in a list
After you created your list you can add or append entries in your list at any time. When you add or append entries in your list, you don’t need to update the rule the list is associated with. The rule automatically incorporates the newly added entries.
Your list can contain up to 100,000 unique entries and each entry can be up to 320 characters.
You can add entries in the Amazon Fraud Detector console, using the API, using the AWS CLI, or using the AWS SDK.
## Add entries in a list using the Amazon Fraud Detector console
**To add one or more entries in a list**
1. Open the [AWS Management Console](https://console.aws.amazon.com) and sign in to your account. Navigate to Amazon Fraud Detector.
1. In the left navigation pane, choose **Lists**.
1. In the **Lists** page, select the list that you want to add entries to.
1. In your list details page, select **List data** tab and choose **Add data**.
1. In the **Add list data** box, add one entry on each line or copy and paste entries from a spreadsheet. Make sure to not use comma to separate entries.
1. Choose **Add**.
## Add entries in a list using the AWS SDK for Python (Boto3)
The following example uses the [UpdateList](https://docs.aws.amazon.com//frauddetector/latest/api/API_UpdateList.html) API operation to add two new entries in the `allow_email_ids` list. Make sure that the entries you are adding are unique in the list.
```
import boto3
fraudDetector = boto3.client('frauddetector')
fraudDetector.update_list (
name = 'allow_email_ids',
updateMode = 'APPEND'
elements = ['emailId_11','emailId_12']
```
# Assign a variable type to a list
Every list you use in a rule must be associated with an Amazon Fraud Detector's [Variable types](variables.md#variable-types) variable type. By default, Amazon Fraud Detector assumes the list to be of FREE\$1FORM\$1TEXT variable type. It is important to note that a list that consists of IP addresses must be associated with IP\$1ADDRESS variable type.
You can associate your list with a variable type either at the time of list creation or anytime later. If you already associated your list with a variable type and want to change it later, you must create a new list. You can’t change the variable type of a list.
You can assign a variable type in the Amazon Fraud Detector console, using the API, using the AWS CLI, or using the AWS SDK.
## Assign variable type to a list using the Amazon Fraud Detector console
**To assign a variable type to a list**
1. Open the [AWS Management Console](https://console.aws.amazon.com) and sign in to your account. Navigate to Amazon Fraud Detector.
1. In the left navigation pane, choose **Lists**.
1. In the **Lists** page, select the list that you want to assign a variable type.
1. In your list details page, choose **Actions** and select **Edit list**.
1. In the **Edit list** box, select the variable type for your list.
1. Choose **Save**.
## Assign variable type to a list using the AWS SDK for Python (Boto3)
The following example uses the [UpdateList](https://docs.aws.amazon.com//frauddetector/latest/api/API_UpdateList.html) API operation to assign a variable type to `allow_ip_address` list.
```
import boto3
fraudDetector = boto3.client('frauddetector')
fraudDetector.update_list (
name = 'allow_ip_address',
variableType = 'IP_ADDRESS'
)
```
# Delete a list
You can delete a list that isn't used in any rule. When you delete a list, Amazon Fraud Detector permanently deletes that list and all entries in the list.
You can delete a list in the Amazon Fraud Detector console, using the API, using the AWS CLI or the AWS SDK.
## Delete list using the Amazon Fraud Detector console
**To delete a list**
1. Open the [AWS Management Console](https://console.aws.amazon.com) and sign in to your account. Navigate to Amazon Fraud Detector.
1. In the left navigation pane, choose **Lists**
1. In the **Lists** page, select the list you want to delete.
1. In your list details page, choose **Actions** and select **Delete list**.
1. Choose **Delete list**.
## Delete list using the AWS SDK for Python (Boto3)
The following example uses the [DeleteList](https://docs.aws.amazon.com//frauddetector/latest/api/API_DeleteList.html) API operation to delete `allow_email_ids`.
```
import boto3
fraudDetector = boto3.client('frauddetector')
fraudDetector.delete_list(
name = 'allow_email_ids'
)
```
# Delete entries from a list
You can delete one or more entries from your lists at any time. When you delete entries in your list you don’t need to update the rule the list is associated with. The rule automatically incorporates the updated list.
You can delete entries from a list in the Amazon Fraud Detector console, using the API, using the AWS CLI or the AWS SDK.
## Delete entries from a list using the Amazon Fraud Detector console
**To delete one or more entries from a list**
1. Open the [AWS Management Console](https://console.aws.amazon.com) and sign in to your account. Navigate to Amazon Fraud Detector.
1. In the left navigation pane, choose **Lists**
1. In the **Lists** page, select the list that contains entries you want to delete.
1. In your list details page, select **List data** tab and select entries you want to delete.
1. Choose **Delete** and choose **Delete** again to confirm.
## Delete entries from a list using the AWS SDK for Python (Boto3)
In the following example the [UpdateList](https://docs.aws.amazon.com//frauddetector/latest/api/API_UpdateList.html) API operation deletes entries from `allow_email_ids` list.
```
import boto3
fraudDetector = boto3.client('frauddetector')
fraudDetector.update_list(
name = 'allow_email_ids',
updateMode = 'REMOVE',
elements = ['emailId_4', 'emailId_12']
)
```
# Delete all entries from a list
You can delete all entries in your list, if the list isn’t being used in a rule. You can delete all the entries that are in the list and later add entries in the same list.
You can delete entries from a list in the Amazon Fraud Detector console, using the API, using the AWS CLI or the AWS SDK.
## Delete all entries from a list using the Amazon Fraud Detector console
**To delete all entries from a list**
1. Open the [AWS Management Console](https://console.aws.amazon.com) and sign in to your account. Navigate to Amazon Fraud Detector.
1. In the left navigation pane, choose **Lists**
1. In the **Lists** page, select the list that contains entries you want to delete.
1. In your list details page, select **List data** tab and choose **Delete all**.
1. In the **Delete all** box, type `delete all` to confirm and then choose **Delete all list data**.
## Delete all entries from a list using the AWS SDK for Python (Boto3)
In the following example the [UpdateList](https://docs.aws.amazon.com//frauddetector/latest/api/API_UpdateList.html) API operation deletes all entries from `allow_email_ids` list.
```
import boto3
fraudDetector = boto3.client('frauddetector')
fraudDetector.update_list(
name = 'allow_email_ids',
updateMode = 'REPLACE',
elements = []
)
```