Skip to main content
Version: 2.0

Create a Value List

POST https://api.fraudio.com/v1/value-lists

Endpoint Overview​

The Value List creation endpoint is part of our Rules Management API, designed to streamline the way you define reusable collections of values for fraud detection rules. With this endpoint, you can programmatically create a named list of values that rules can reference in their triggers, so you update values in one place instead of editing every rule.

tip

For any questions or uncertainties regarding this endpoint, our Support Team is available for assistance.

Request Parameters​

Request parameters in JSON format​

Toggle to view an example of request parameters in JSON format for creating a value list
json
{
"displayName": "Blocked countries",
"entries": ["ru", "kp"],
"matchType": "exact",
"slug": "blocked_countries"
}

Request parameters: Field Reference Table​

FieldData TypeDescription
displayNameString
Human-readable name of the value list. Required.
slugString
Stable identifier used when referencing the list from a rule. Letters, digits, and underscores only ([A-Za-z0-9_]+). Optional; if omitted, derived from displayName.
entriesArray of String
Values in the list. Required. Entries are trimmed; blank values and exact duplicates are removed. Exact-match lists support at most 5000 entries.
matchTypeString
Comparison mode for membership checks. Required.

Response Parameters​

Status CodeStatus MessageDescriptionSchema
200OKStandard response for successful HTTP requests.200 OK - Value List creation response
4xx, 500, 501, 502, 503, 504errorVarious error messages for unsuccessful HTTP requests.Problem response

Code Samples​

curl -X POST 'https://api.fraudio.com/v1/value-lists' \
-H 'Content-Type: application/json' \
-H "authorization: Bearer $ACCESS_TOKEN" \
--data-raw '{
"displayName":"Blocked countries",
"entries":["ru","kp"],
"matchType":"exact",
"slug":"blocked_countries"
}'