Overview

The Automation feature in Fireblocks allows you to create automation rules that automatically initiate actions based on triggers and conditions you define. Automation rules are saved on the Automation page and can be activated, deactivated, and reviewed as needed.

This article describes all options for creating an automation rule. See templates for rebalancing, topping up an account, sweeping accounts, and collecting a service fee for specific rule examples.

Creating an automation rule

All rule parameters are described in the sections below. To create a new automation rule, follow these steps:

1. In the Fireblocks Console, go to the Automation page and select Create automation.
2. Enter a name for the rule in the top-left corner.
3. Define the trigger.
4. Define the condition.
5. Define the action to take when the trigger and condition are met.
6. Enter an internal note if needed. The note will appear in the recent activity panel and the Transaction History page.
7. Select Save.
8. Enable the automation rule.

Triggers

Automation rules are triggered based on either:

• Time
• Transaction 

The rule parameters are dynamic depending on the trigger.

Time

The automation rule is triggered based on a predefined time. Select a time interval:

• Minute and Hour: These time intervals allow you to define how frequently, in minutes or hours, the automation rule should be triggered. These time intervals are based on UTC. Automation rules with these time intervals are triggered at the next rounded interval. For example, a rule created to be triggered every 24 hours will trigger at 00:00 UTC regardless of when it was created.
  • Range: This setting allows you to set intervals during a specific time of the day. For example, every 10 minutes between 08:00 and 10:00, and between 16:00 and 17:00.
• Daily: This time interval allows you to define a specific time the rule should be triggered. This time interval is based on the local time zone when the rule is created.
• Weekly: This time interval allows you to define specific days and a time that the rule should be triggered. This time interval is based on the local time zone when the rule is created.
• Monthly: This time interval allows you to define days of each month and a time the rule should be triggered. This time interval is based on the local time zone when the rule is created.

Transaction

The automation rule is triggered based on any transaction involving one or more vault, exchange, or fiat accounts, whitelisted addresses, or Network profiles. You must choose which account(s) send or receive the transaction, and the asset type that triggers the rule.

Account name

You must choose at least one source account, and at least one destination account. You can select each account manually, or enable Any account.

Vault account range

This option allows you to assign a range of vault accounts according to their ID number.

Each vault has a unique ID assigned in sequential order of when it was created, starting with 0. You can find a vault's ID number in the URL by navigating to that vault account in the Fireblocks Console.

Asset

Select an asset from the drop down menu to limit the automation rule to transactions that include the selected. Alternatively, select any asset to allow the rule to be triggered only based on the transaction source and destination set above.

Conditions

Automation conditions are based on one of the following:

• Balance
• Transaction amount
• Unconditional

Specific amounts can be set in either the asset balance or USD. 

Balance

The automation rule can be based on a specific amount or percentage of a specific asset in the selected account.

• Specific amount: Select the asset’s balance that triggers the automation rule and how it compares to the balance you define for the rule. 
• Percentage: Select the accounts whose balances should be added together and compared to the original account’s balance.

Transaction amount

This automation rule can initiate an action based on the amount of the transaction that triggered the rule. You can choose whether the transaction value must be equal, greater than, less than, greater than or equal to, or less than or equal to a defined amount for the action to be initiated. 

Unconditional

The automation rule can initiate an action without meeting any conditions. In this instance, the rule is triggered only based on the selected time interval.

Actions

Automation rules that are triggered, and their conditions met, will initiate the action you have configured. This action can be signed automatically by an API Co-Signer or manually using a mobile device. The actions available are:

• Transfer
• Top up
• Rebalance
• Payment flow

Transfer

Transfer source and destination

Select a specific vault, exchange, or fiat account that will initiate the transfer. Alternatively, select Transaction destination account under From to inherit the transfer source from the trigger settings.

Transfer asset

Either select a specific asset you would like to transfer, or select Inherited asset to transfer the asset defined in the trigger settings.

Transfer type

Define the amount of the asset transferred from one account to another. The following options are available:

• Specific amount: Transfer a set amount any time the rule is triggered.
• Full amount: The total balance of the asset in the source account. 
• Partial amount: Leave a percentage or a specific balance in the source account.
• Inherited amount: Transfer the exact amount deposited in the transaction defined in the trigger settings.

Top up

Additional funds of a specific asset are sent to the selected account to meet a defined balance. You can choose which vault, exchange, or fiat account sends the funds and which vault, exchange, fiat account, or whitelisted address is topped up.

Rebalance

Funds are distributed between two accounts to meet a defined percentage. Select the asset to rebalance, and the percentage each account should hold of that asset.

If you select a whitelisted address as one of the accounts, funds can only be transferred to the whitelisted address during the rebalance. If the whitelisted address balance is over the selected percentage for the rebalance and requires funds to be moved from it, the automation rule will fail.

Payment flow

One of your payment flows is initiated. You can choose which payment flow to initiate and whether to use a specific amount, a percentage, the full amount, or an inherited amount of the asset. Inherited amount is only available if the asset defined in the Condition is the same asset defined in the first step in the payment flow.

• This action is only available if you've purchased the Payments feature.
• Payment flows must be created before you can include them in an automation rule. Learn more about creating payment flows.

Enabling automation rules

Once you create an automation rule, it must be approved by your workspace admin quorum. Then you must activate the automation to allow it to run as defined. Learn more about managing your automation rules.