Create a new policy

Create a new policy to automatically control transaction behavior. Policies define rules that allow, block, or require approval for transactions based on conditions like amount, recipient, or asset type.

Request Body

Field	Type	Required	Description
`name`	string	Yes	Human-readable policy name (max 255 chars, unique in org)
`description`	string	No	Description of policy purpose and behavior
`type`	string	No	Action type (TRANSFER, CONTRACT_CALL, RAW_SIGNING, TYPED_MESSAGE)
`status`	string	No	Initial status (default: DRAFT)
`enforcementMode`	string	No	STRICT (default) or ADVISORY
`conditionLogic`	string	No	ALL (default, AND logic) or ANY (OR logic)
`priority`	number	No	Evaluation order (default: 100, lower = higher priority)
`conditions`	array	Yes	Array of condition objects (at least one required)
`actions`	array	Yes	Array of action objects

Condition Object

Field	Type	Description
`field`	string	Field to evaluate (e.g., transaction.amount, transaction.recipient)
`operator`	string	Comparison operator (e.g., GREATER_THAN, EQUALS, IN_LIST)
`value`	any	Value to compare against
`unit`	string	Optional unit (e.g., USD for amounts)

Action Object

Field	Type	Description
`type`	string	ALLOW, BLOCK, REQUIRE_APPROVAL, or NOTIFY
`requiredApprovers`	number	Required for REQUIRE_APPROVAL (minimum 2)
`approverListId`	string	Optional named list ID for approvers
`notificationTarget`	string	Required for NOTIFY action

Required Permission

policies:create

Create a new policy

Create a new policy to automatically control transaction behavior. Policies define rules that allow, block, or require approval for transactions based on conditions like amount, recipient, or asset type.

Request Body

Field	Type	Required	Description
`name`	string	Yes	Human-readable policy name (max 255 chars, unique in org)
`description`	string	No	Description of policy purpose and behavior
`type`	string	No	Action type (TRANSFER, CONTRACT_CALL, RAW_SIGNING, TYPED_MESSAGE)
`status`	string	No	Initial status (default: DRAFT)
`enforcementMode`	string	No	STRICT (default) or ADVISORY
`conditionLogic`	string	No	ALL (default, AND logic) or ANY (OR logic)
`priority`	number	No	Evaluation order (default: 100, lower = higher priority)
`conditions`	array	Yes	Array of condition objects (at least one required)
`actions`	array	Yes	Array of action objects

Condition Object

Field	Type	Description
`field`	string	Field to evaluate (e.g., transaction.amount, transaction.recipient)
`operator`	string	Comparison operator (e.g., GREATER_THAN, EQUALS, IN_LIST)
`value`	any	Value to compare against
`unit`	string	Optional unit (e.g., USD for amounts)

Action Object

Field	Type	Description
`type`	string	ALLOW, BLOCK, REQUIRE_APPROVAL, or NOTIFY
`requiredApprovers`	number	Required for REQUIRE_APPROVAL (minimum 2)
`approverListId`	string	Optional named list ID for approvers
`notificationTarget`	string	Required for NOTIFY action

Required Permission

policies:create