# YNAB

YNAB (You Need A Budget) is a budgeting tool helping users track expenses, plan finances, and gain control over spending to reduce debt

- **Category:** accounting
- **Auth:** OAUTH2
- **Composio Managed App Available?** Yes
- **Tools:** 27
- **Triggers:** 0
- **Slug:** `YNAB`
- **Version:** 20260316_00

## Tools

### Create a new account in a budget

**Slug:** `YNAB_CREATE_ACCOUNT`

Tool to create a new account in a budget. Use when you need to add a manual (non-linked) account to a specific budget.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `account` | object | Yes | The account object to create with name, type, and initial balance |
| `budget_id` | string | Yes | ID of the budget in which to create the account. Use 'default' for the default budget or 'last-used' for the last used budget. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Scheduled Transaction

**Slug:** `YNAB_CREATE_SCHEDULED_TRANSACTION`

Creates a scheduled (recurring) transaction in a YNAB budget. Use this to set up bills, recurring expenses, or income that repeats on a schedule. Requires an account_id (from YNAB_LIST_ACCOUNTS), a date, frequency, and amount in milliunits.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `budget_id` | string | Yes | Budget UUID or literal 'last-used'/'default' to operate on |
| `scheduled_transaction` | object | Yes | Scheduled transaction object to create |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Scheduled Transaction

**Slug:** `YNAB_DELETE_SCHEDULED_TRANSACTION`

Permanently deletes a scheduled transaction from a YNAB budget. Use this when a recurring transaction is no longer needed. This action cannot be undone. Obtain the scheduled_transaction_id from list_scheduled_transactions or get_scheduled_transaction_by_id before calling this.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `budget_id` | string | Yes | The budget UUID, or use 'last-used' to target the last used budget, or 'default' when default budget selection is enabled. |
| `scheduled_transaction_id` | string | Yes | The UUID of the scheduled transaction to delete. Obtain this from list_scheduled_transactions or get_scheduled_transaction_by_id. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Account by ID

**Slug:** `YNAB_GET_ACCOUNT_BY_ID`

Tool to retrieve a single account resource. Use when you need details of a specific account by its ID after determining the budget.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `budget_id` | string | Yes | Budget identifier; use 'default' if the default budget selection is enabled for your OAuth app. |
| `account_id` | string | Yes | Account identifier (UUID) within the specified budget. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Budget By ID

**Slug:** `YNAB_GET_BUDGET_BY_ID`

Retrieve a complete budget export by ID, including all accounts, categories, payees, and transactions. Use this tool when you need comprehensive budget data. The response includes: - Budget metadata (name, date/currency formats) - All accounts with balances - Category groups and categories with budgeted amounts and balances - All payees - All transactions and scheduled transactions (optional, may be large) For incremental syncing, use last_knowledge_of_server to only fetch changes since your last request. Note: Currency amounts are in 'milliunits' format (divide by 1000 for standard units).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `budget_id` | string | Yes | The ID of the budget to retrieve. Use 'last-used' for the most recently accessed budget, or 'default' if default budget selection is enabled in YNAB settings. |
| `last_knowledge_of_server` | integer | No | Optional. If provided, returns only entities changed since this server knowledge value (delta request). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Budget Month

**Slug:** `YNAB_GET_BUDGET_MONTH`

Tool to retrieve a specific budget month. Use when you need detailed summary and category budgets for a given month after confirming the budget ID. Monetary amounts are returned in milliunits (divide by 1000 for standard currency). Response includes high-level aggregates and a nested category array within the month payload for per-category budget analysis.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `month` | string | Yes | Budget month in ISO 8601 format (YYYY-MM-01) or 'current' for the current calendar month (UTC). |
| `budget_id` | string | Yes | Budget identifier; if OAuth 'default budget selection' is enabled, you may use 'default'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Budget Settings

**Slug:** `YNAB_GET_BUDGET_SETTINGS`

Tool to retrieve budget-level settings. Use when you need to fetch currency and date formatting preferences for a specific budget.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `budget_id` | string | Yes | ID of the budget to fetch settings for. Supports special values like 'last-used' or 'default'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Category by ID

**Slug:** `YNAB_GET_CATEGORY_BY_ID`

Retrieve a single YNAB budget category by its ID. Use this to get detailed category information including budgeted amounts, activity, balance, and goal settings. Amounts are returned for the current budget month (UTC). Requires both budget_id and category_id - use 'last-used' or 'default' for budget_id if you don't have a specific budget ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `budget_id` | string | Yes | The budget ID (UUID format). Use 'last-used' for the most recently accessed budget, or 'default' if default budget selection is enabled. |
| `category_id` | string | Yes | The unique identifier (UUID) of the category to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Month Category By ID

**Slug:** `YNAB_GET_MONTH_CATEGORY_BY_ID`

Tool to retrieve a single category for a specific budget month. Use after selecting the budget and month when you need month-specific category details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `month` | string | Yes | Budget month in ISO 8601 full-date format (YYYY-MM-DD). |
| `budget_id` | string | Yes | Budget identifier; use 'default' if default budget selection is enabled. |
| `category_id` | string | Yes | Category identifier (UUID) within the specified budget month. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Payee by ID

**Slug:** `YNAB_GET_PAYEE_BY_ID`

Tool to retrieve a single payee by its ID. Use when you need full details of a payee after confirming the budget and payee selection.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `payee_id` | string | Yes | The unique identifier (UUID) of the payee to retrieve. |
| `budget_id` | string | Yes | The budget identifier. Can be a UUID, 'default' (if OAuth default budget selection is enabled), or 'last-used' to reference the last accessed budget. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Scheduled Transaction by ID

**Slug:** `YNAB_GET_SCHEDULED_TRANSACTION_BY_ID`

Tool to retrieve a single scheduled transaction. Use when you need details of a specific scheduled transaction by its ID after confirming the budget.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `budget_id` | string | Yes | The budget UUID or special value: 'last-used' for the last accessed budget, or 'default' if default budget selection is enabled in YNAB settings. |
| `scheduled_transaction_id` | string | Yes | The UUID of the scheduled transaction to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Transaction by ID

**Slug:** `YNAB_GET_TRANSACTION_BY_ID`

Tool to retrieve a single transaction by its ID. Use when you need detailed information for a specific transaction after confirming the budget.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `budget_id` | string | Yes | The budget ID. Use 'default' to reference the default budget when OAuth default budget selection is enabled, or 'last-used' for the last accessed budget. |
| `transaction_id` | string | Yes | The UUID of the transaction to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Authorized User

**Slug:** `YNAB_GET_USER`

Tool to retrieve the authorized user's information. Use after authentication to get current user details.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Accounts

**Slug:** `YNAB_LIST_ACCOUNTS`

Retrieves all accounts for a specified YNAB budget. Use this tool to: - Get a complete list of accounts (checking, savings, credit cards, loans, etc.) in a budget - Retrieve account IDs for use with other YNAB account-related operations - Monitor account balances (current, cleared, and uncleared) - Perform efficient delta syncing by passing last_knowledge_of_server Returns account details including balances in milliunits (1000 milliunits = 1 currency unit). For example, a balance of 150000 milliunits equals $150.00. Note: Use 'default' or 'last-used' as budget_id for convenience, or obtain specific budget UUIDs from the List Budgets endpoint.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `budget_id` | string | Yes | The budget UUID or special value. Use 'default' for the user's default budget, or 'last-used' for the most recently accessed budget. Alternatively, provide a specific budget UUID obtained from the List Budgets endpoint. |
| `last_knowledge_of_server` | integer | No | If provided, only entities that have changed since this server knowledge value will be included in the response (delta request). Obtain this value from a previous response's server_knowledge field for efficient syncing. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Budgets

**Slug:** `YNAB_LIST_BUDGETS`

Retrieves all budgets accessible to the authenticated YNAB user. Use this tool to: - Get a list of all budgets in the user's YNAB account - Retrieve budget IDs for use with other YNAB operations - Optionally include account details for each budget Returns budget summaries including name, last modification time, date range, and formatting preferences. Budget IDs from this response are required for most other YNAB API operations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `include_accounts` | boolean | No | If True, includes the list of accounts for each budget in the response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Categories

**Slug:** `YNAB_LIST_CATEGORIES`

Tool to list all category groups and their categories for a budget. Use when you need the full set of budget categories or only those changed since last sync. Category names may include emojis or near-identical labels; always use category_id from the response in downstream requests.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `budget_id` | string | Yes | Budget identifier; use 'default' if the default budget selection is enabled for your OAuth app. |
| `last_knowledge_of_server` | integer | No | For delta syncing: only return categories changed since this server knowledge. Response will include an updated server_knowledge. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Budget Months

**Slug:** `YNAB_LIST_MONTHS`

Tool to list months for a budget with summary information. Use when you need an overview of all months or only changed months since a given knowledge value (delta requests).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `budget_id` | string | Yes | The budget UUID to list months for. Use 'last-used' to specify the last accessed budget, or 'default' if default budget selection is enabled in the OAuth application settings. |
| `last_knowledge_of_server` | integer | No | Server knowledge value from a previous response. When provided, only months that have changed since this value will be returned (delta request). Omit for a full list of months. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Payee Locations

**Slug:** `YNAB_LIST_PAYEE_LOCATIONS`

Retrieves all GPS locations associated with payees in a budget. Payee locations are recorded when transactions are saved using the YNAB mobile apps, storing GPS coordinates to help pre-populate nearby payees. Use this tool when you need to find all recorded locations for payees in a budget. Note: Not all payees will have locations recorded.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `budget_id` | string | Yes | The ID of the budget (UUID format). Use 'last-used' to specify the last used budget, or 'default' if default budget selection is enabled in your YNAB account settings. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Payee Locations by Payee

**Slug:** `YNAB_LIST_PAYEE_LOCATIONS_BY_PAYEE`

Retrieves all GPS locations associated with a specific payee in a budget. Payee locations are recorded when transactions are saved using the YNAB mobile apps, storing GPS coordinates to help pre-populate nearby payees. Use this tool when you need to find where a payee's transactions typically occur. Note: Not all payees will have locations recorded.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `payee_id` | string | Yes | The unique identifier (UUID) of the payee to retrieve locations for. |
| `budget_id` | string | Yes | The ID of the budget (UUID format). Use 'last-used' to specify the last used budget, or 'default' if default budget selection is enabled in your YNAB account settings. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List payees in a budget

**Slug:** `YNAB_LIST_PAYEES`

Tool to list payees in a budget. Use when you need all payees or only those changed since a known server knowledge value.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `budget_id` | string | Yes | Budget identifier (UUID). Use 'last-used' to refer to the last accessed budget or 'default' if OAuth default budget selection is enabled. |
| `last_knowledge_of_server` | integer | No | Only return entities changed since this server knowledge value (delta requests). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Scheduled Transactions

**Slug:** `YNAB_LIST_SCHEDULED_TRANSACTIONS`

List all scheduled (recurring) transactions for a YNAB budget. Returns future-dated transactions that repeat on a schedule (e.g., rent, subscriptions, paychecks). Supports delta sync to fetch only changes since a previous request using the server_knowledge value.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `budget_id` | string | Yes | The budget ID. Use 'last-used' to get the last used budget, or 'default' if default budget selection is enabled. Otherwise, provide the actual budget UUID. |
| `last_knowledge_of_server` | integer | No | Server knowledge value for delta sync. When provided, only scheduled transactions changed since this value are returned. Use the server_knowledge value from a previous response. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Transactions

**Slug:** `YNAB_LIST_TRANSACTIONS`

Tool to list transactions in a budget. Use when you need all or delta-filtered transactions after confirming the budget. Omitting all filters returns the full transaction history, which may produce large payloads; prefer since_date, type, or last_knowledge_of_server to scope results.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string ("uncategorized" | "unapproved") | No | Filter by transaction type; supported values: 'uncategorized', 'unapproved'. |
| `budget_id` | string | Yes | Budget identifier (UUID). Use 'default' if default budget selection is enabled, or 'last-used' to specify the last used budget. |
| `since_date` | string | No | Only include transactions on or after this ISO date (YYYY-MM-DD). |
| `last_knowledge_of_server` | integer | No | Optional. If provided, returns only entities changed since this server knowledge value (delta request). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Transactions by Account

**Slug:** `YNAB_LIST_TRANSACTIONS_BY_ACCOUNT`

Tool to list transactions for a specific account. Use when you need all or delta-filtered transactions for a given account after confirming the budget and account ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string ("uncategorized" | "unapproved") | No | If specified, only transactions of the specified type will be included. Use 'uncategorized' to get transactions without a category, or 'unapproved' to get transactions that have not been approved. |
| `budget_id` | string | Yes | The ID of the budget. Use 'default' if default budget selection is enabled, or 'last-used' to specify the last used budget. |
| `account_id` | string | Yes | The ID of the account to retrieve transactions from (UUID format). |
| `since_date` | string | No | If specified, only transactions on or after this date will be included. The date should be ISO formatted (e.g., '2024-01-01'). |
| `last_knowledge_of_server` | integer | No | The starting server knowledge value. If provided, only entities that have changed since this value will be included (delta request). Useful for syncing. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Transactions by Category

**Slug:** `YNAB_LIST_TRANSACTIONS_BY_CATEGORY`

Tool to list transactions for a specific category (excludes pending). Use when you need completed transactions for a given category after obtaining budget_id and category_id. Response includes deleted transactions; filter client-side using the deleted boolean field.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string ("uncategorized" | "unapproved") | No | Filter by transaction type; supported values: 'uncategorized', 'unapproved'. |
| `budget_id` | string | Yes | Budget identifier (UUID). Use 'default' if default budget selection is enabled, or 'last-used' to specify the last used budget. |
| `since_date` | string | No | Only include transactions on or after this ISO date (YYYY-MM-DD). No upper-bound parameter exists; apply client-side filtering for bounded date ranges. |
| `category_id` | string | Yes | Category identifier whose transactions are to be retrieved. Confirm the exact UUID before fetching; category names may be ambiguous due to similar labels or emoji. |
| `last_knowledge_of_server` | integer | No | Delta-style filter; only return entities changed since this server knowledge index. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Transactions by Payee

**Slug:** `YNAB_LIST_TRANSACTIONS_BY_PAYEE`

Tool to list transactions for a specific payee in a budget. Use when you need to fetch all non-pending transactions for a payee after confirming budget and payee IDs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `type` | string ("uncategorized" | "unapproved") | No | Optional filter by transaction type: 'uncategorized' or 'unapproved'. |
| `payee_id` | string | Yes | Payee identifier to filter transactions. |
| `budget_id` | string | Yes | Budget identifier; use 'default' for the default budget if enabled for your OAuth app. |
| `since_date` | string | No | Optional ISO date (YYYY-MM-DD). Only include transactions on or after this date. |
| `last_knowledge_of_server` | integer | No | Optional. If provided, returns only entities changed since this server knowledge value (delta request). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Payee

**Slug:** `YNAB_UPDATE_PAYEE`

Tool to update a payee. Use when you need to rename an existing payee.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The new name for the payee. |
| `payee_id` | string | Yes | The unique identifier (UUID) of the payee to update. |
| `budget_id` | string | Yes | Budget identifier. Use 'default' if OAuth default budget selection is enabled. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Scheduled Transaction

**Slug:** `YNAB_UPDATE_SCHEDULED_TRANSACTION`

Update an existing scheduled transaction in YNAB. Allows modifying the date, frequency, amount, payee, category, memo, or account of a scheduled transaction. Use YNAB_LIST_SCHEDULED_TRANSACTIONS first to get the scheduled_transaction_id. Amounts should be in milliunits (negative for expenses, positive for income).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `budget_id` | string | Yes | Budget UUID or literal 'last-used'/'default' to operate on |
| `scheduled_transaction` | object | Yes | Fields of the scheduled transaction to update |
| `scheduled_transaction_id` | string | Yes | Identifier of the scheduled transaction to update |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |