Routines
Last updated: November 24, 2025
Overview
Routines are the instructions to move money, while Transfers are the actual vehicle that move the money. Routines are the parent object of Transfers. A Transfer is a child object of the Routine. A Transfer cannot exist without a Routine. There are one-time Routines and recurring Routines. There are various kinds of recurring routines, some with fixed amounts and others with variable amounts. A Routine can have multiple Transfers, but a Transfer cannot have multiple Routines.
Types of Routines
One Time
Move money between two authorized accounts on a specific date.
Request Body:
JSON
[
{
"type": "one-time",
"name": "My One Time Transfer",
"source_id": "your_source_id",
"destination_id": "your_destination_id",
"amount": 20,
"start_date": "2020-10-29"
}
]In Practice:
A User can select a One Time Transfer, specifying the amount that they would like to transfer and where the Transfer should be deposited. The Routine will run once created, checking the balance of the Source Account before initiating the Transfer to ensure that no accounts are overdrawn.
Routine Specific Parameters Required:
ParameterData TypeDescription | ||
type |
| The type of Routine ( |
amount |
| The amount of the transfer |
Recurring
Move a specified amount of money from one authorized Account to another authorized Account on a recurring basis starting on a specific date.
Request Body:
JSON
[
{
"type": "recurring",
"name": "My Recurring Routine",
"source_id": "your_source_id",
"destination_id": "your_destination_id",
"amount": 20,
"start_date": "2020-10-29",
"frequency": "monthly"
}
]In Practice:
When a User creates a Recurring Transfer, they must define the amount that they want to transfer and then the frequency the Routine should run. Once created, the Routine will run at the prescribed interval, checking the balance of the Source Account before initiating the Transfer to ensure that no accounts are overdrawn.
Like all Routines, it can be Paused (or Activated again). When Paused, it will not create a new Transfer even when the time interval is triggered. It can be Deleted as well, where it will no longer run again and will be removed from the active Routines list.
Routine Specific Parameters Required:
ParameterData TypeDescription | ||
type |
| The type of Routine ( |
amount |
| The amount of the transfer |
start_date |
| The date the Routine should start processing (timezone is "America/Los_Angeles") |
frequency |
| The frequency a repeating Routine should process ( |
Peer-to-Peer
Move money between two authorized accounts, from one authorized User to another.
Request Body:
JSON
[
{
"type": "one-time",
"name": "My P2P Transfer",
"source_id": "your_source_id",
"destination_id": "your_destination_id",
"destination_user_id": "your_id_for_the_receiving_user",
"amount": 20,
"start_date": "2020-10-29"
}
]In Practice:
Transferring funds between two different Users is almost exactly like a One Time Transfer Routine; however, the request body includes an additional parameter that defines the User that will receive the funds. The parameters that differentiate the Sending User and Receiving User are as follows:
Sending User:
access_tokenfrom the authorization header defines the authorization for the User sending fundssource_idindicates the source of funds, and must be one of the Sending User's Accounts
Receiving User:
destination_user_idis theuser_idfor the Receiving User, which must have an activeaccess_tokendestination_idindicates the destination of funds, and must be one of the Receiving User's Accounts
Routine Specific Parameters Required:
ParameterData TypeDescription | ||
type |
| The type of Routine ( |
amount |
| The amount of the transfer |
destination_user_id |
| The ID of the Receiving User |
start_date |
| The date the Routine should start processing (timezone is "America/Los_Angeles") |
Appendix
Routine Frequency
FrequencyTriggerExample | ||
| Same day of the week as the | A routine with a |
| Same day of the week as the | A routine with a |
| Same day of the month as the | A routine with a |