YNAB icon

YNAB

Personal budgeting on YNAB — pull plans, accounts, categories, payees, months, transactions and scheduled transactions; create and update accounts, categories, category groups, payees, transactions (single or bulk) and scheduled transactions; trigger vendor Direct Import.

28 searches17 actionsPollingAuth: OAuth

AI-assisted documentation15 min read

This documentation is compiled from our integration source code, internal specs for YNAB, its official API documentation and anonymized requests logs we collect from our support team[2].

Open YNAB on WEXTL →

Before you set up the credential, make sure you have an active YNAB account and OAuth client credentials, granted by signing in with your account ready.[3]

You’ll be redirected to sign in and approve access — your password is never shared with WEXTL.

  • Client IDpasswordRequired

    Issued when you register a new OAuth Application in your Account Settings > Developer Settings.

    [1]
  • Client SecretpasswordRequired

    Issued when you register a new OAuth Application in your Account Settings > Developer Settings.

    [1]
  1. Log in to your WEXTL account, add the YNAB node module to your workflow, and click Create new credential.
  2. Optional: In the Credential name field, enter a name for the credential.
  3. Enter the authentication credentials you copied from your YNAB account, or follow the on-screen instructions to create the credential.
  4. If prompted, authenticate your account and confirm access.
  5. If you want to make changes to your credential in the future, follow the steps in Manage credentials →

Notes

Credentials are org-scoped; share them with teammates from the Credentials picker on any of its nodes.For detailed information on connecting an application, see Connect an application →

Get AccountSearch
Input fields[3]
FieldType
Plan IDRequired
choice
Output fields[3]
FieldType
Accountobject
IDtext
Nametext
Typetext
On Budgetboolean
Closedboolean
Notetext
Balance (Milliunits)number
Cleared Balance (Milliunits)number
Uncleared Balance (Milliunits)number
Transfer Payee IDtext
Get CategorySearch
Input fields[3]
FieldType
Plan IDRequired
choice
Output fields[3]
FieldType
Categoryobject
IDtext
Category Group IDtext
Category Group Nametext
Nametext
Hiddenboolean
Internalboolean
Original Category Group ID (Deprecated, always null)text
Notetext
Budgeted (Milliunits)number
Activity (Milliunits)number
Get MonthSearch
Input fields[3]
FieldType
Plan IDRequired
choice
Output fields[3]
FieldType
Monthobject
Monthdate
Notetext
Income (Milliunits)number
Budgeted (Milliunits)number
Activity (Milliunits)number
To Be Budgeted (Milliunits)number
Age of Moneynumber
Deletedboolean
Income (Formatted)text
Income (Currency)number
Get Month CategorySearch
Input fields[3]
FieldType
Plan IDRequired
choice
Output fields[3]
FieldType
Categoryobject
IDtext
Category Group IDtext
Category Group Nametext
Nametext
Hiddenboolean
Internalboolean
Original Category Group ID (Deprecated, always null)text
Notetext
Budgeted (Milliunits)number
Activity (Milliunits)number
Get PayeeSearch
Input fields[3]
FieldType
Plan IDRequired
choice
Output fields[3]
FieldType
Payeeobject
IDtext
Nametext
Transfer Account IDtext
Deletedboolean
Get Payee LocationSearch
Input fields[3]
FieldType
Plan IDRequired
choice
Output fields[3]
FieldType
Payee Locationobject
IDtext
Payee IDtext
Latitudetext
Longitudetext
Deletedboolean
Get PlanSearch
Input fields[3]
FieldType
Plan IDRequired
choice
Last Knowledge of Servernumber
Output fields[3]
FieldType
Planobject
IDtext
Nametext
Last Modified Ondate
First Monthdate
Last Monthdate
Date Formatobject
Currency Formatobject
Accountsarray
Payeesarray
Payee Locationsarray
Server Knowledgenumber
Get Plan SettingsSearch
Input fields[3]
FieldType
Plan IDRequired
choice
Output fields[3]
FieldType
Settingsobject
Date Formatobject
Currency Formatobject
Get Scheduled TransactionSearch
Input fields[3]
FieldType
Plan IDRequired
choice
Output fields[3]
FieldType
Scheduled Transactionobject
IDtext
Date Firstdate
Date Nextdate
Frequencytext
Amount (Milliunits)number
Memotext
Flag Colortext
Flag Nametext
Account IDtext
Account Nametext
Get TransactionSearch
Input fields[3]
FieldType
Plan IDRequired
choice
Output fields[3]
FieldType
Transactionobject
IDtext
Datedate
Amount (Milliunits)number
Memotext
Clearedtext
Approvedboolean
Flag Colortext
Flag Nametext
Account IDtext
Account Nametext
Server Knowledgenumber
Get UserSearch
Output fields[3]
FieldType
Userobject
IDtext
List AccountsSearch
Input fields[3]
FieldType
Plan IDRequired
choice
Last Knowledge of Servernumber
Output fields[3]
FieldType
Accountsarray
IDtext
Nametext
Typetext
On Budgetboolean
Closedboolean
Notetext
Balance (Milliunits)number
Cleared Balance (Milliunits)number
Uncleared Balance (Milliunits)number
Transfer Payee IDtext
Server Knowledgenumber
List CategoriesSearch
Input fields[3]
FieldType
Plan IDRequired
choice
Last Knowledge of Servernumber
Output fields[3]
FieldType
Category Groupsarray
IDtext
Nametext
Hiddenboolean
Internalboolean
Deletedboolean
Categoriesarray
Server Knowledgenumber
List Money Movement GroupsSearch
Input fields[3]
FieldType
Plan IDRequired
choice
Output fields[3]
FieldType
Money Movement Groupsarray
IDtext
Group Created Atdate
Monthdate
Notetext
Performed By User IDtext
Server Knowledgenumber
List Money Movement Groups by MonthSearch
Input fields[3]
FieldType
Plan IDRequired
choice
Output fields[3]
FieldType
Money Movement Groupsarray
IDtext
Group Created Atdate
Monthdate
Notetext
Performed By User IDtext
Server Knowledgenumber
List Money MovementsSearch
Input fields[3]
FieldType
Plan IDRequired
choice
Output fields[3]
FieldType
Money Movementsarray
IDtext
Monthdate
Moved Atdate
Notetext
Money Movement Group IDtext
Performed By User IDtext
From Category IDtext
To Category IDtext
Amount (Milliunits)number
Amount (Formatted)text
Server Knowledgenumber
List Money Movements by MonthSearch
Input fields[3]
FieldType
Plan IDRequired
choice
Output fields[3]
FieldType
Money Movementsarray
IDtext
Monthdate
Moved Atdate
Notetext
Money Movement Group IDtext
Performed By User IDtext
From Category IDtext
To Category IDtext
Amount (Milliunits)number
Amount (Formatted)text
Server Knowledgenumber
List MonthsSearch
Input fields[3]
FieldType
Plan IDRequired
choice
Last Knowledge of Servernumber
Output fields[3]
FieldType
Monthsarray
Monthdate
Notetext
Income (Milliunits)number
Budgeted (Milliunits)number
Activity (Milliunits)number
To Be Budgeted (Milliunits)number
Age of Moneynumber
Deletedboolean
Income (Formatted)text
Income (Currency)number
Server Knowledgenumber
List Payee LocationsSearch
Input fields[3]
FieldType
Plan IDRequired
choice
Output fields[3]
FieldType
Payee Locationsarray
IDtext
Payee IDtext
Latitudetext
Longitudetext
Deletedboolean
List Payee Locations by PayeeSearch
Input fields[3]
FieldType
Plan IDRequired
choice
Output fields[3]
FieldType
Payee Locationsarray
IDtext
Payee IDtext
Latitudetext
Longitudetext
Deletedboolean
List PayeesSearch
Input fields[3]
FieldType
Plan IDRequired
choice
Last Knowledge of Servernumber
Output fields[3]
FieldType
Payeesarray
IDtext
Nametext
Transfer Account IDtext
Deletedboolean
Server Knowledgenumber
List PlansSearch
Input fields[3]
FieldType
Include Accountsboolean
Output fields[3]
FieldType
Plansarray
IDtext
Nametext
Last Modified Ondate
First Monthdate
Last Monthdate
Date Formatobject
Currency Formatobject
Accountsarray
Default Planobject
IDtext
Nametext
List Scheduled TransactionsSearch
Input fields[3]
FieldType
Plan IDRequired
choice
Last Knowledge of Servernumber
Output fields[3]
FieldType
Scheduled Transactionsarray
IDtext
Date Firstdate
Date Nextdate
Frequencytext
Amount (Milliunits)number
Memotext
Flag Colortext
Flag Nametext
Account IDtext
Account Nametext
Server Knowledgenumber
List TransactionsSearch
Input fields[3]
FieldType
Plan IDRequired
choice
Since Datedate
Until Datedate
typechoice
Last Knowledge of Servernumber
Output fields[3]
FieldType
Transactionsarray
IDtext
Datedate
Amount (Milliunits)number
Memotext
Clearedtext
Approvedboolean
Flag Colortext
Flag Nametext
Account IDtext
Account Nametext
Server Knowledgenumber
List Transactions by AccountSearch
Input fields[3]
FieldType
Plan IDRequired
choice
Since Datedate
Until Datedate
typechoice
Last Knowledge of Servernumber
Output fields[3]
FieldType
Transactionsarray
IDtext
Datedate
Amount (Milliunits)number
Memotext
Clearedtext
Approvedboolean
Flag Colortext
Flag Nametext
Account IDtext
Account Nametext
Server Knowledgenumber
List Transactions by CategorySearch
Input fields[3]
FieldType
Plan IDRequired
choice
Since Datedate
Until Datedate
typechoice
Last Knowledge of Servernumber
Output fields[3]
FieldType
Transactionsarray
IDtext
Datedate
Amount (Milliunits)number
Memotext
Clearedtext
Approvedboolean
Flag Colortext
Flag Nametext
Account IDtext
Account Nametext
Server Knowledgenumber
List Transactions by MonthSearch
Input fields[3]
FieldType
Plan IDRequired
choice
Since Datedate
Until Datedate
typechoice
Last Knowledge of Servernumber
Output fields[3]
FieldType
Transactionsarray
IDtext
Datedate
Amount (Milliunits)number
Memotext
Clearedtext
Approvedboolean
Flag Colortext
Flag Nametext
Account IDtext
Account Nametext
Server Knowledgenumber
List Transactions by PayeeSearch
Input fields[3]
FieldType
Plan IDRequired
choice
Since Datedate
Until Datedate
typechoice
Last Knowledge of Servernumber
Output fields[3]
FieldType
Transactionsarray
IDtext
Datedate
Amount (Milliunits)number
Memotext
Clearedtext
Approvedboolean
Flag Colortext
Flag Nametext
Account IDtext
Account Nametext
Server Knowledgenumber
Create AccountAction
Input fields[3]
FieldType
Plan IDRequired
choice
NameRequired
text
TypeRequired
choice
BalanceRequired
number
Output fields[3]
FieldType
Accountobject
IDtext
Nametext
Typetext
On Budgetboolean
Closedboolean
Notetext
Balance (Milliunits)number
Cleared Balance (Milliunits)number
Uncleared Balance (Milliunits)number
Transfer Payee IDtext
Create CategoryAction
Input fields[3]
FieldType
Plan IDRequired
choice
Category Group IDRequired
choice
NameRequired
text
Notetext
Goal Targetnumber
Goal Target Datedate
Goal Needs Whole Amountboolean
goal_frequencychoice
Output fields[3]
FieldType
Categoryobject
IDtext
Category Group IDtext
Category Group Nametext
Nametext
Hiddenboolean
Internalboolean
Original Category Group ID (Deprecated, always null)text
Notetext
Budgeted (Milliunits)number
Activity (Milliunits)number
Server Knowledgenumber
Create Category GroupAction
Input fields[3]
FieldType
Plan IDRequired
choice
NameRequired
text
Output fields[3]
FieldType
Category Groupobject
IDtext
Nametext
Hiddenboolean
Internalboolean
Deletedboolean
Server Knowledgenumber
Create PayeeAction
Input fields[3]
FieldType
Plan IDRequired
choice
NameRequired
text
Output fields[3]
FieldType
Payeeobject
IDtext
Nametext
Transfer Account IDtext
Deletedboolean
Server Knowledgenumber
Create Scheduled TransactionAction
Input fields[3]
FieldType
Plan IDRequired
choice
Account IDRequired
choice
DateRequired
date
Amountnumber
Payee IDchoice
Payee Nametext
Category IDchoice
Memotext
flag_colorchoice
frequencychoice
Output fields[3]
FieldType
Scheduled Transactionobject
IDtext
Date Firstdate
Date Nextdate
Frequencytext
Amount (Milliunits)number
Memotext
Flag Colortext
Flag Nametext
Account IDtext
Account Nametext
Create TransactionAction
Input fields[3]
FieldType
Plan IDRequired
choice
Transactionobject
Account IDRequired
choice
DateRequired
date
AmountRequired
number
Payee IDchoice
Payee Nametext
Category IDchoice
Memotext
clearedchoice
Approvedboolean
flag_colorchoice
Transactions (Bulk)array
Transactionobject
Output fields[3]
FieldType
Transaction IDsarray
Transactionobject
IDtext
Datedate
Amount (Milliunits)number
Memotext
Clearedtext
Approvedboolean
Flag Colortext
Flag Nametext
Account IDtext
Account Nametext
Transactionsarray
IDtext
Datedate
Amount (Milliunits)number
Memotext
Clearedtext
Approvedboolean
Flag Colortext
Flag Nametext
Account IDtext
Account Nametext
Duplicate Import IDsarray
Server Knowledgenumber
Delete Scheduled TransactionAction
Input fields[3]
FieldType
Plan IDRequired
choice
Output fields[3]
FieldType
Scheduled Transactionobject
IDtext
Date Firstdate
Date Nextdate
Frequencytext
Amount (Milliunits)number
Memotext
Flag Colortext
Flag Nametext
Account IDtext
Account Nametext
Delete TransactionAction
Input fields[3]
FieldType
Plan IDRequired
choice
Output fields[3]
FieldType
Transactionobject
IDtext
Datedate
Amount (Milliunits)number
Memotext
Clearedtext
Approvedboolean
Flag Colortext
Flag Nametext
Account IDtext
Account Nametext
Server Knowledgenumber
Import TransactionsAction
Input fields[3]
FieldType
Plan IDRequired
choice
Output fields[3]
FieldType
Transaction IDsarray
Make an API Calluniversal
Input fields[3]
FieldType
URLRequired
text
MethodRequired
choice
Headersarray
Headerobject
Query Stringarray
Parameterobject
Bodytext
Output fields[3]
FieldType
Bodytext
Headersobject
Status codenumber
Update CategoryAction
Input fields[3]
FieldType
Plan IDRequired
choice
Nametext
Notetext
Category Group IDchoice
Goal Targetnumber
Goal Target Datedate
Goal Needs Whole Amountboolean
goal_frequencychoice
Output fields[3]
FieldType
Categoryobject
IDtext
Category Group IDtext
Category Group Nametext
Nametext
Hiddenboolean
Internalboolean
Original Category Group ID (Deprecated, always null)text
Notetext
Budgeted (Milliunits)number
Activity (Milliunits)number
Server Knowledgenumber
Update Category GroupAction
Input fields[3]
FieldType
Plan IDRequired
choice
NameRequired
text
Output fields[3]
FieldType
Category Groupobject
IDtext
Nametext
Hiddenboolean
Internalboolean
Deletedboolean
Server Knowledgenumber
Update Month CategoryAction
Input fields[3]
FieldType
Plan IDRequired
choice
BudgetedRequired
number
Output fields[3]
FieldType
Categoryobject
IDtext
Category Group IDtext
Category Group Nametext
Nametext
Hiddenboolean
Internalboolean
Original Category Group ID (Deprecated, always null)text
Notetext
Budgeted (Milliunits)number
Activity (Milliunits)number
Server Knowledgenumber
Update PayeeAction
Input fields[3]
FieldType
Plan IDRequired
choice
NameRequired
text
Output fields[3]
FieldType
Payeeobject
IDtext
Nametext
Transfer Account IDtext
Deletedboolean
Server Knowledgenumber
Update Scheduled TransactionAction
Input fields[3]
FieldType
Plan IDRequired
choice
Account IDRequired
choice
DateRequired
date
Amountnumber
Payee IDchoice
Payee Nametext
Category IDchoice
Memotext
flag_colorchoice
frequencychoice
Output fields[3]
FieldType
Scheduled Transactionobject
IDtext
Date Firstdate
Date Nextdate
Frequencytext
Amount (Milliunits)number
Memotext
Flag Colortext
Flag Nametext
Account IDtext
Account Nametext
Update TransactionAction
Input fields[3]
FieldType
Plan IDRequired
choice
Account IDchoice
Datedate
Amountnumber
Payee IDchoice
Payee Nametext
Category IDchoice
Memotext
clearedchoice
Approvedboolean
flag_colorchoice
Subtransactionsarray
Subtransactionobject
Output fields[3]
FieldType
Transactionobject
IDtext
Datedate
Amount (Milliunits)number
Memotext
Clearedtext
Approvedboolean
Flag Colortext
Flag Nametext
Account IDtext
Account Nametext
Server Knowledgenumber
Update Transactions (Bulk)Action
Input fields[3]
FieldType
Plan IDRequired
choice
TransactionsRequired
array
Transactionobject
Output fields[3]
FieldType
Transaction IDsarray
Transactionsarray
IDtext
Datedate
Amount (Milliunits)number
Memotext
Clearedtext
Approvedboolean
Flag Colortext
Flag Nametext
Account IDtext
Account Nametext
Duplicate Import IDsarray
Server Knowledgenumber

Look for YNAB templates in the WEXTL template library.

Browse templates →
  1. WEXTL® YNAB Source Code connector implementation.
  2. Our users use cases and automations.
  3. Official API Documentation for YNAB.
  4. WEXTL® visual workflow builder data.

Last updated: Sep 5, 2026 10:06