Create named list
Create a new named list for use in policy conditions. Named lists allow you to define reusable sets of blockchain addresses that can be referenced in multiple policies.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Human-readable name (max 255 chars, unique in org) |
type | string | Yes | List type identifier (currently only address lists supported) |
description | string | No | Detailed description of the list's purpose |
status | string | No | ACTIVE (default) or INACTIVE |
items | array | No | Initial address items (Ethereum addresses, default: []) |
metadata | object | No | Additional key-value metadata |
Response Fields
| Field | Type | Description |
|---|---|---|
id | UUID | Unique list identifier |
name | string | List name |
type | string | List type |
description | string | List description |
status | string | ACTIVE or INACTIVE |
items | string[] | Array of list items |
metadata | object | Additional metadata |
organizationId | UUID | Owning organization ID |
itemCount | number | Number of items in the list |
createdAt | string | Creation timestamp (ISO 8601) |
updatedAt | string | Last update timestamp (ISO 8601) |
Use Cases
- Create address whitelists for approved recipients
- Build sanctioned address blacklists
- Define recipient address restrictions for policies
- Manage address-based policy conditions
Required Permission
lists:create
Create named list
Create a new named list for use in policy conditions. Named lists allow you to define reusable sets of blockchain addresses that can be referenced in multiple policies.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
name | string | Yes | Human-readable name (max 255 chars, unique in org) |
type | string | Yes | List type identifier (currently only address lists supported) |
description | string | No | Detailed description of the list's purpose |
status | string | No | ACTIVE (default) or INACTIVE |
items | array | No | Initial address items (Ethereum addresses, default: []) |
metadata | object | No | Additional key-value metadata |
Response Fields
| Field | Type | Description |
|---|---|---|
id | UUID | Unique list identifier |
name | string | List name |
type | string | List type |
description | string | List description |
status | string | ACTIVE or INACTIVE |
items | string[] | Array of list items |
metadata | object | Additional metadata |
organizationId | UUID | Owning organization ID |
itemCount | number | Number of items in the list |
createdAt | string | Creation timestamp (ISO 8601) |
updatedAt | string | Last update timestamp (ISO 8601) |
Use Cases
- Create address whitelists for approved recipients
- Build sanctioned address blacklists
- Define recipient address restrictions for policies
- Manage address-based policy conditions
Required Permission
lists:create