< Back
Add-YnabTransaction
Post
NAME Add-YnabTransaction
SYNOPSIS
Adds a transaction to YNAB.
SYNTAX
Add-YnabTransaction [-Budget] <String> [-Account] <String> [-Payee] <String> [-Category] <String> [[-Memo]
<String>] [-Outflow] <Double> [[-Date] <DateTime>] [[-Token] <Object>] [[-FlagColor] <String>] [[-Cleared]]
[[-Approved] <Boolean>] [[-StoreAs] <String>] [<CommonParameters>]
Add-YnabTransaction [-Preset] <String[]> [[-Memo] <String>] [-Amount] <Double> [[-Date] <DateTime>] [[-Token]
<Object>] [[-FlagColor] <String>] [[-Cleared]] [[-Approved] <Boolean>] [[-StoreAs] <String>] [<CommonParameters>]
Add-YnabTransaction [-Preset] <String[]> [[-Memo] <String>] [-Inflow] <Double> [[-Date] <DateTime>] [[-Token]
<Object>] [[-FlagColor] <String>] [[-Cleared]] [[-Approved] <Boolean>] [[-StoreAs] <String>] [<CommonParameters>]
Add-YnabTransaction [-Preset] <String[]> [[-Memo] <String>] [-Outflow] <Double> [[-Date] <DateTime>] [[-Token]
<Object>] [[-FlagColor] <String>] [[-Cleared]] [[-Approved] <Boolean>] [[-StoreAs] <String>] [<CommonParameters>]
Add-YnabTransaction [-Preset] <String[]> [[-Budget] <String>] [[-Account] <String>] [[-Payee] <String>]
[[-Category] <String>] [[-Memo] <String>] [[-Date] <DateTime>] [[-Token] <Object>] [[-FlagColor] <String>]
[[-Cleared]] [[-Approved] <Boolean>] [[-StoreAs] <String>] [<CommonParameters>]
Add-YnabTransaction [-Budget] <String> [-Account] <String> [-Payee] <String> [-Category] <String> [[-Memo]
<String>] [-Amount] <Double> [[-Date] <DateTime>] [[-Token] <Object>] [[-FlagColor] <String>] [[-Cleared]]
[[-Approved] <Boolean>] [[-StoreAs] <String>] [<CommonParameters>]
Add-YnabTransaction [-Budget] <String> [-Account] <String> [-Payee] <String> [-Category] <String> [[-Memo]
<String>] [-Inflow] <Double> [[-Date] <DateTime>] [[-Token] <Object>] [[-FlagColor] <String>] [[-Cleared]]
[[-Approved] <Boolean>] [[-StoreAs] <String>] [<CommonParameters>]
DESCRIPTION
Adds a transaction to YNAB.
PARAMETERS
-Preset <String[]>
The name of the preset to load (see: Add-YnabTransactionPreset).
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-Budget <String>
The name of the budget to add the transaction to.
Required? true
Position? 2
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Account <String>
The name of the account to add the transaction to.
Required? true
Position? 3
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Payee <String>
The name of the payee to add the transaction to.
Required? true
Position? 4
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Category <String>
The name of the category to add the transaction to.
Required? true
Position? 5
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Memo <String>
Memo for the transaction.
Required? false
Position? 6
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Outflow <Double>
Outflow amount for the transaction.
Uses absolute value, so a positive or negative number can be provided.
Required? true
Position? 7
Default value 0
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Inflow <Double>
Inflow amount for the transaction.
Uses absolute value, so a positive or negative number can be provided.
Required? true
Position? 7
Default value 0
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Amount <Double>
Amount for the transaction. Negative = Outflow, Positive = Inflow
Required? true
Position? 7
Default value 0
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Date <DateTime>
Date for the trarnsaction.
Defaults to today.
Required? false
Position? 8
Default value (Get-Date)
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Token <Object>
YNAB API token.
Required? false
Position? 9
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-FlagColor <String>
Flag color for the transaction.
Required? false
Position? 10
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Cleared [<SwitchParameter>]
If specified the transaction will be marked as CLeared.
Required? false
Position? 11
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Approved <Boolean>
If specified the transaction will be marked as Approved.
Defaults to $true.
Required? false
Position? 12
Default value True
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-StoreAs <String>
Preset name to save the transaction as, allowing the transaction details to be re-used with the Preset
parameter (see: Add-YnabTransactionPreset).
Required? false
Position? 13
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>Add-YnabTransaction -Budget 'TestBudget' -Account 'Checking' -Category 'Food' -Memo 'Coffee' -Outflow 3.50
-Token $ynabToken
Adds a transaction to TestBudget with the specified account, category, memo, and outflow.
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>Add-YnabTransaction -Budget 'TestBudget' -Account 'Checking' -Category 'Food' -Memo 'Coffee' -Outflow 3.50
-Token $ynabToken -StoreAs 'Coffee'
Adds a transaction to TestBudget with the specified account, category, memo, and outflow.
Stores the transaction as a preset called 'Coffee' (see: Add-YnabTransactionPreset).
-------------------------- EXAMPLE 3 --------------------------
PS C:\\>Add-YnabTransaction -PresetName 'Coffee'
Adds a transaction to YNAB using the settings from the 'Coffee' transaction preset (see:
Get-YnabTransactionPreset).
-------------------------- EXAMPLE 4 --------------------------
PS C:\\>Add-YnabTransaction -PresetName 'Coffee' -Inflow 3.50 -Memo 'Refund' -StoreAs 'Coffee Refund'
Adds a transaction to YNAB using the settings from the 'Coffee' transaction preset, but overrides the existing
amount and memo, then stores the new details as 'Coffee Refund'.
RELATED LINKS
SYNOPSIS
Adds a transaction to YNAB.
SYNTAX
Add-YnabTransaction [-Budget] <String> [-Account] <String> [-Payee] <String> [-Category] <String> [[-Memo]
<String>] [-Outflow] <Double> [[-Date] <DateTime>] [[-Token] <Object>] [[-FlagColor] <String>] [[-Cleared]]
[[-Approved] <Boolean>] [[-StoreAs] <String>] [<CommonParameters>]
Add-YnabTransaction [-Preset] <String[]> [[-Memo] <String>] [-Amount] <Double> [[-Date] <DateTime>] [[-Token]
<Object>] [[-FlagColor] <String>] [[-Cleared]] [[-Approved] <Boolean>] [[-StoreAs] <String>] [<CommonParameters>]
Add-YnabTransaction [-Preset] <String[]> [[-Memo] <String>] [-Inflow] <Double> [[-Date] <DateTime>] [[-Token]
<Object>] [[-FlagColor] <String>] [[-Cleared]] [[-Approved] <Boolean>] [[-StoreAs] <String>] [<CommonParameters>]
Add-YnabTransaction [-Preset] <String[]> [[-Memo] <String>] [-Outflow] <Double> [[-Date] <DateTime>] [[-Token]
<Object>] [[-FlagColor] <String>] [[-Cleared]] [[-Approved] <Boolean>] [[-StoreAs] <String>] [<CommonParameters>]
Add-YnabTransaction [-Preset] <String[]> [[-Budget] <String>] [[-Account] <String>] [[-Payee] <String>]
[[-Category] <String>] [[-Memo] <String>] [[-Date] <DateTime>] [[-Token] <Object>] [[-FlagColor] <String>]
[[-Cleared]] [[-Approved] <Boolean>] [[-StoreAs] <String>] [<CommonParameters>]
Add-YnabTransaction [-Budget] <String> [-Account] <String> [-Payee] <String> [-Category] <String> [[-Memo]
<String>] [-Amount] <Double> [[-Date] <DateTime>] [[-Token] <Object>] [[-FlagColor] <String>] [[-Cleared]]
[[-Approved] <Boolean>] [[-StoreAs] <String>] [<CommonParameters>]
Add-YnabTransaction [-Budget] <String> [-Account] <String> [-Payee] <String> [-Category] <String> [[-Memo]
<String>] [-Inflow] <Double> [[-Date] <DateTime>] [[-Token] <Object>] [[-FlagColor] <String>] [[-Cleared]]
[[-Approved] <Boolean>] [[-StoreAs] <String>] [<CommonParameters>]
DESCRIPTION
Adds a transaction to YNAB.
PARAMETERS
-Preset <String[]>
The name of the preset to load (see: Add-YnabTransactionPreset).
Required? true
Position? 1
Default value
Accept pipeline input? true (ByValue, ByPropertyName)
Accept wildcard characters? false
-Budget <String>
The name of the budget to add the transaction to.
Required? true
Position? 2
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Account <String>
The name of the account to add the transaction to.
Required? true
Position? 3
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Payee <String>
The name of the payee to add the transaction to.
Required? true
Position? 4
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Category <String>
The name of the category to add the transaction to.
Required? true
Position? 5
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Memo <String>
Memo for the transaction.
Required? false
Position? 6
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Outflow <Double>
Outflow amount for the transaction.
Uses absolute value, so a positive or negative number can be provided.
Required? true
Position? 7
Default value 0
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Inflow <Double>
Inflow amount for the transaction.
Uses absolute value, so a positive or negative number can be provided.
Required? true
Position? 7
Default value 0
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Amount <Double>
Amount for the transaction. Negative = Outflow, Positive = Inflow
Required? true
Position? 7
Default value 0
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Date <DateTime>
Date for the trarnsaction.
Defaults to today.
Required? false
Position? 8
Default value (Get-Date)
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Token <Object>
YNAB API token.
Required? false
Position? 9
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-FlagColor <String>
Flag color for the transaction.
Required? false
Position? 10
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Cleared [<SwitchParameter>]
If specified the transaction will be marked as CLeared.
Required? false
Position? 11
Default value False
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Approved <Boolean>
If specified the transaction will be marked as Approved.
Defaults to $true.
Required? false
Position? 12
Default value True
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-StoreAs <String>
Preset name to save the transaction as, allowing the transaction details to be re-used with the Preset
parameter (see: Add-YnabTransactionPreset).
Required? false
Position? 13
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>Add-YnabTransaction -Budget 'TestBudget' -Account 'Checking' -Category 'Food' -Memo 'Coffee' -Outflow 3.50
-Token $ynabToken
Adds a transaction to TestBudget with the specified account, category, memo, and outflow.
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>Add-YnabTransaction -Budget 'TestBudget' -Account 'Checking' -Category 'Food' -Memo 'Coffee' -Outflow 3.50
-Token $ynabToken -StoreAs 'Coffee'
Adds a transaction to TestBudget with the specified account, category, memo, and outflow.
Stores the transaction as a preset called 'Coffee' (see: Add-YnabTransactionPreset).
-------------------------- EXAMPLE 3 --------------------------
PS C:\\>Add-YnabTransaction -PresetName 'Coffee'
Adds a transaction to YNAB using the settings from the 'Coffee' transaction preset (see:
Get-YnabTransactionPreset).
-------------------------- EXAMPLE 4 --------------------------
PS C:\\>Add-YnabTransaction -PresetName 'Coffee' -Inflow 3.50 -Memo 'Refund' -StoreAs 'Coffee Refund'
Adds a transaction to YNAB using the settings from the 'Coffee' transaction preset, but overrides the existing
amount and memo, then stores the new details as 'Coffee Refund'.
RELATED LINKS