Skip to main content
Rules

Creating rules

How to create a rule, choose whether it changes your data in Synci or only shapes data on the way out, and attach it to accounts and linked accounts.

Written By Matias

Last updated 1 day ago

Rules can be used to automatically handle or transform transactions, and are a powerful tool for improving your workflows and the quality of your data.

Rule types

Synci has two kinds of rules. Both are built the same way, with conditions and actions, but they change different things. You choose the kind when you create a rule, and it cannot be changed afterwards.

Change my data in Synci

These rules are applied to transactions as they are fetched from the bank accounts the rule is attached to. Changes are saved in Synci, so they show up across the app and everywhere the transaction is transferred or shared. On the rule's page, this kind is labeled Bank Account Rule.

Because they change stored transactions, turning one of these rules off later does not undo changes it has already made.

Only on the way out

These rules shape transactions as they leave Synci, without changing your stored data. On the rule's page, this kind is labeled Transfer Rule. You can attach one:

  • To a linked account, to shape what that one destination receives.

  • To a bank account, as an output rule. It then shapes everything the account sends out: its linked accounts, the API, SimpleFIN apps, webhooks and AI assistants. When a transaction is transferred, the account's output rules run first, then the linked account's own rules.

You don't pick a destination for these rules. Synci works out which destinations a rule fits from its actions. Setting the payee, description, date or amount works with every destination. Setting a field that only YNAB or only Lunch Money has limits the rule to that destination, and raw transaction fields only reach Google Sheets and Notion (plus the API, SimpleFIN apps and webhooks when the rule is an output rule). You can only attach a rule where it fits.

Rules aren't available for brokerage or crypto accounts, or for linked accounts that send from them.

On Basic you get 2 rules for each connection you pay for, up to 5 rules attached to one account or linked account, and 1 condition and 1 action per rule. Pro has no limit on the number of rules, up to 10 per account or linked account, and up to 5 conditions and 5 actions per rule. See synci.io/pricing for details.


Creating a rule

To create a rule, head to the Rules page and click the Create rule button. A short dialog walks you through it:

  1. Where should this rule apply? Choose Bank accounts to change an account's stored data or shape what it sends out, or Linked accounts to shape transactions on their way to a destination.

  2. Choose the account: Pick the bank account or linked account the rule should start on. Brokerage and crypto accounts are not listed.

  3. How the rule applies: For a bank account, choose Change my data in Synci or Only on the way out, as described in the Rule types section above. A rule for a linked account always applies only on the way out, so you won't see this choice.

  4. Name: Give the rule a short name that describes its purpose (e.g. "Reverse amounts"), then click Create rule.

The rule is created already attached to the account or linked account you picked, and its page opens so you can build it. You can attach it to more accounts later, and add a description on its Settings tab.

You can also start from an account or a linked account: the Add rule button on its Rules tab skips straight to the last step.

Set up conditions

Conditions live in the When section of the Builder tab. Click Add Condition, then choose a field, an operator and a value. Conditions are criteria that must be met for a rule to be applied. If a rule has no conditions, it runs on every transaction.

With two or more conditions, use the Match All / Any control to decide whether every condition has to match, or just one of them.

Set up actions

Actions live in the Then section. Click Add Action, pick the field to change, and enter the value to set. Actions are executed from top to bottom when a rule's conditions are met, and you can drag them or use the arrows to change their order. Rules that apply only on the way out also have a Stop transfer button, which keeps matching transactions from being sent. Every time an action is executed, a new rule log is created.

When you're done, click Save changes. To try the rule on real transactions first, click Test at the top of the page. A test is a dry run: nothing is saved or transferred.

Attach rule

A rule only runs where it is attached. Your new rule is already attached to the account or linked account you created it for. To attach it somewhere else, click Attach at the top of the rule's page:

  1. Choose where to attach it. Rules that change your data in Synci can be attached to bank accounts. Rules that apply only on the way out can be attached to the linked accounts they fit and, if all of their actions work as an output rule, to bank accounts too. In that case you choose between Linked accounts and Bank accounts first.

  2. Set the Rule execution order. This is the order in which the rules attached to that account or linked account run. Drag a rule's handle or use the arrows to move it.

  3. Click Attach rule.

For example, if a "Reverse amount" rule is listed below an "Admin rule", the "Admin rule" runs first when a new transaction arrives, and the "Reverse amount" rule runs after it. Any values transformed by the first rule persist into the next rule's execution.

Example: Assume Synci has fetched a new transaction with 100 as the amount. If the first rule has an action which multiplies the amount by 10, the new transaction amount becomes 1000. Then, when the second rule (which multiplies amount with -1) is executed, the final amount for the transaction will be set to -1000.

On a bank account, rules that change your data and output rules each have their own order.

The Attached tab on the rule's page lists every account and linked account the rule is attached to. To stop it running somewhere, click Detach. To change the execution order later, open More and choose Reorder.


Configuring rules

The following article goes in detail about how rules work, and the different ways you can configure them to best suit your needs.

Rule configuration