Skip to main content
Server path: /xero-accounting | Type: Application | PCID required: Yes

Tools

ToolDescription
xero_accounting_create_accountCreates a new chart of accounts
xero_accounting_create_branding_theme_payment_servicesCreates a new custom payment service for a specific branding theme
xero_accounting_create_currencyCreate a new currency for a Xero organisation
xero_accounting_create_manual_journalsCreates one or more manual journals
xero_accounting_create_tax_ratesCreates one or more tax rates
xero_accounting_delete_accountDeletes a chart of accounts
xero_accounting_get_accountRetrieves a single chart of accounts by using a unique account Id
xero_accounting_get_accountsRetrieves the full chart of accounts
xero_accounting_get_branding_themeRetrieves a specific branding theme using a unique branding theme Id
xero_accounting_get_branding_theme_payment_servicesRetrieves the payment services for a specific branding theme
xero_accounting_get_branding_themesRetrieves all the branding themes
xero_accounting_get_budgetRetrieves a specific budget, which includes budget lines
xero_accounting_get_budgetsRetrieve a list of budgets
xero_accounting_get_currenciesRetrieves currencies for your Xero organisation
xero_accounting_get_journalRetrieves a specific journal using a unique journal Id.
xero_accounting_get_journal_by_numberRetrieves a specific journal using a unique journal number.
xero_accounting_get_journalsRetrieves journals
xero_accounting_get_manual_journalRetrieves a specific manual journal
xero_accounting_get_manual_journalsRetrieves manual journals
xero_accounting_get_organisation_actionsRetrieves a list of the key actions your app has permission to perform in the connected Xero organisation.
xero_accounting_get_organisation_cissettingsRetrieves the CIS settings for the Xero organistaion.
xero_accounting_get_organisationsRetrieves Xero organisation details
xero_accounting_get_report_aged_payables_by_contactRetrieves report for aged payables by contact
xero_accounting_get_report_aged_receivables_by_contactRetrieves report for aged receivables by contact
xero_accounting_get_report_balance_sheetRetrieves report for balancesheet
xero_accounting_get_report_bank_summaryRetrieves report for bank summary
xero_accounting_get_report_budget_summaryRetrieves report for budget summary
xero_accounting_get_report_executive_summaryRetrieves report for executive summary
xero_accounting_get_report_from_idRetrieves a specific report using a unique ReportID
xero_accounting_get_report_profit_and_lossRetrieves report for profit and loss
xero_accounting_get_report_ten_ninety_nineRetrieve reports for 1099
xero_accounting_get_report_trial_balanceRetrieves report for trial balance
xero_accounting_get_reports_listRetrieves a list of the organistaions unique reports that require a uuid to fetch
xero_accounting_get_tax_rate_by_tax_typeRetrieves a specific tax rate according to given TaxType code
xero_accounting_get_tax_ratesRetrieves tax rates
xero_accounting_get_userRetrieves a specific user
xero_accounting_get_usersRetrieves users
xero_accounting_post_setupSets the chart of accounts, the conversion date and conversion balances
xero_accounting_update_accountUpdates a chart of accounts
xero_accounting_update_manual_journalUpdates a specific manual journal
xero_accounting_update_or_create_manual_journalsUpdates or creates a single manual journal
xero_accounting_update_tax_rateUpdates tax rates

xero_accounting_create_account

Creates a new chart of accounts Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
Idempotency-KeystringNoThis allows you to safely retry requests without the risk of duplicate processing. 128 character max.
AccountIDstringNoThe Xero identifier for an account – specified as a string following the endpoint name e.g. /297c2dc5-cc47-4afd-8ec8-74990b8761e9
AddToWatchlistbooleanNoBoolean – describes whether the account is shown in the watchlist widget on the dashboard
BankAccountNumberstringNoFor bank accounts only (Account Type BANK)
BankAccountTypestringNoFor bank accounts only. See Bank Account types
ClassstringNoSee Account Class Types
CodestringNoCustomer defined alpha numeric account code e.g 200 or SALES (max length = 10)
CurrencyCodestringNo3 letter alpha code for the currency – see list of currency codes
DescriptionstringNoDescription of the Account. Valid for all types of accounts except bank accounts (max length = 4000)
EnablePaymentsToAccountbooleanNoBoolean – describes whether account can have payments applied to it
HasAttachmentsbooleanNoboolean to indicate if an account has an attachment (read only)
NamestringNoName of account (max length = 150)
ReportingCodestringNoShown if set
ReportingCodeNamestringNoShown if set
ShowInExpenseClaimsbooleanNoBoolean – describes whether account code is available for use with expense claims
StatusstringNoAccounts with a status of ACTIVE can be updated to ARCHIVED. See Account Status Codes
SystemAccountstringNoIf this is a system account then this element is returned. See System Account types. Note that non-system accounts may have this element set as either “” or null.
TaxTypestringNoThe tax type from taxRates
TypestringNoSee Account Types
UpdatedDateUTCstringNoLast modified date UTC format
ValidationErrorsobject[]NoDisplays array of validation error messages from the API

xero_accounting_create_branding_theme_payment_services

Creates a new custom payment service for a specific branding theme Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
Idempotency-KeystringNoThis allows you to safely retry requests without the risk of duplicate processing. 128 character max.
BrandingThemeIDstringYesUnique identifier for a Branding Theme
PaymentServicesany[]NoPayment Services

xero_accounting_create_currency

Create a new currency for a Xero organisation Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
Idempotency-KeystringNoThis allows you to safely retry requests without the risk of duplicate processing. 128 character max.
CodestringNo3 letter alpha code for the currency – see list of currency codes
DescriptionstringNoName of Currency

xero_accounting_create_manual_journals

Creates one or more manual journals Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
summarizeErrorsbooleanNoIf false return 200 OK and mix of successfully created objects and any with validation errors
Idempotency-KeystringNoThis allows you to safely retry requests without the risk of duplicate processing. 128 character max.
ManualJournalsobject[]NoManual Journals
paginationobjectNoThe pagination value
Warningsobject[]NoDisplays array of warning messages from the API

xero_accounting_create_tax_rates

Creates one or more tax rates Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
Idempotency-KeystringNoThis allows you to safely retry requests without the risk of duplicate processing. 128 character max.
TaxRatesobject[]NoTax Rates

xero_accounting_delete_account

Deletes a chart of accounts Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
AccountIDstringYesUnique identifier for Account object

xero_accounting_get_account

Retrieves a single chart of accounts by using a unique account Id Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
AccountIDstringYesUnique identifier for Account object

xero_accounting_get_accounts

Retrieves the full chart of accounts Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
If-Modified-SincestringNoOnly records created or modified since this timestamp will be returned
wherestringNoFilter by an any element
orderstringNoOrder by an any element

xero_accounting_get_branding_theme

Retrieves a specific branding theme using a unique branding theme Id Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
BrandingThemeIDstringYesUnique identifier for a Branding Theme

xero_accounting_get_branding_theme_payment_services

Retrieves the payment services for a specific branding theme Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
BrandingThemeIDstringYesUnique identifier for a Branding Theme

xero_accounting_get_branding_themes

Retrieves all the branding themes Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant

xero_accounting_get_budget

Retrieves a specific budget, which includes budget lines Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
BudgetIDstringYesUnique identifier for Budgets
DateTostringNoFilter by start date
DateFromstringNoFilter by end date

xero_accounting_get_budgets

Retrieve a list of budgets Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
IDsstringNoFilter by BudgetID. Allows you to retrieve a specific individual budget.
DateTostringNoFilter by start date
DateFromstringNoFilter by end date

xero_accounting_get_currencies

Retrieves currencies for your Xero organisation Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
wherestringNoFilter by an any element
orderstringNoOrder by an any element

xero_accounting_get_journal

Retrieves a specific journal using a unique journal Id. Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
JournalIDstringYesUnique identifier for a Journal

xero_accounting_get_journal_by_number

Retrieves a specific journal using a unique journal number. Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
JournalNumberintegerYesNumber of a Journal

xero_accounting_get_journals

Retrieves journals Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
If-Modified-SincestringNoOnly records created or modified since this timestamp will be returned
offsetintegerNoOffset by a specified journal number. e.g. journals with a JournalNumber greater than the offset will be returned
paymentsOnlybooleanNoFilter to retrieve journals on a cash basis. Journals are returned on an accrual basis by default.

xero_accounting_get_manual_journal

Retrieves a specific manual journal Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
ManualJournalIDstringYesUnique identifier for a ManualJournal

xero_accounting_get_manual_journals

Retrieves manual journals Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
If-Modified-SincestringNoOnly records created or modified since this timestamp will be returned
wherestringNoFilter by an any element
orderstringNoOrder by an any element
pageintegerNoe.g. page=1 – Up to 100 manual journals will be returned in a single API call with line items shown for each overpayment
pageSizeintegerNoNumber of records to retrieve per page

xero_accounting_get_organisation_actions

Retrieves a list of the key actions your app has permission to perform in the connected Xero organisation. Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant

xero_accounting_get_organisation_cissettings

Retrieves the CIS settings for the Xero organistaion. Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
OrganisationIDstringYesThe unique Xero identifier for an organisation

xero_accounting_get_organisations

Retrieves Xero organisation details Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant

xero_accounting_get_report_aged_payables_by_contact

Retrieves report for aged payables by contact Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
contactIdstringYesUnique identifier for a Contact
datestringNoThe date of the Aged Payables By Contact report
fromDatestringNofilter by the from date of the report e.g. 2021-02-01
toDatestringNofilter by the to date of the report e.g. 2021-02-28

xero_accounting_get_report_aged_receivables_by_contact

Retrieves report for aged receivables by contact Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
contactIdstringYesUnique identifier for a Contact
datestringNoThe date of the Aged Receivables By Contact report
fromDatestringNofilter by the from date of the report e.g. 2021-02-01
toDatestringNofilter by the to date of the report e.g. 2021-02-28

xero_accounting_get_report_balance_sheet

Retrieves report for balancesheet Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
datestringNoThe date of the Balance Sheet report
periodsintegerNoThe number of periods for the Balance Sheet report
timeframestringNoThe period size to compare to (MONTH, QUARTER, YEAR)
trackingOptionID1stringNoThe tracking option 1 for the Balance Sheet report
trackingOptionID2stringNoThe tracking option 2 for the Balance Sheet report
standardLayoutbooleanNoThe standard layout boolean for the Balance Sheet report
paymentsOnlybooleanNoreturn a cash basis for the Balance Sheet report

xero_accounting_get_report_bank_summary

Retrieves report for bank summary Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
fromDatestringNofilter by the from date of the report e.g. 2021-02-01
toDatestringNofilter by the to date of the report e.g. 2021-02-28

xero_accounting_get_report_budget_summary

Retrieves report for budget summary Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
datestringNoThe date for the Bank Summary report e.g. 2018-03-31
periodsintegerNoThe number of periods to compare (integer between 1 and 12)
timeframeintegerNoThe period size to compare to (1=month, 3=quarter, 12=year)

xero_accounting_get_report_executive_summary

Retrieves report for executive summary Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
datestringNoThe date for the Bank Summary report e.g. 2018-03-31

xero_accounting_get_report_from_id

Retrieves a specific report using a unique ReportID Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
ReportIDstringYesUnique identifier for a Report

xero_accounting_get_report_profit_and_loss

Retrieves report for profit and loss Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
fromDatestringNofilter by the from date of the report e.g. 2021-02-01
toDatestringNofilter by the to date of the report e.g. 2021-02-28
periodsintegerNoThe number of periods to compare (integer between 1 and 12)
timeframestringNoThe period size to compare to (MONTH, QUARTER, YEAR)
trackingCategoryIDstringNoThe trackingCategory 1 for the ProfitAndLoss report
trackingCategoryID2stringNoThe trackingCategory 2 for the ProfitAndLoss report
trackingOptionIDstringNoThe tracking option 1 for the ProfitAndLoss report
trackingOptionID2stringNoThe tracking option 2 for the ProfitAndLoss report
standardLayoutbooleanNoReturn the standard layout for the ProfitAndLoss report
paymentsOnlybooleanNoReturn cash only basis for the ProfitAndLoss report

xero_accounting_get_report_ten_ninety_nine

Retrieve reports for 1099 Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
reportYearstringNoThe year of the 1099 report

xero_accounting_get_report_trial_balance

Retrieves report for trial balance Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
datestringNoThe date for the Trial Balance report e.g. 2018-03-31
paymentsOnlybooleanNoReturn cash only basis for the Trial Balance report

xero_accounting_get_reports_list

Retrieves a list of the organistaions unique reports that require a uuid to fetch Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant

xero_accounting_get_tax_rate_by_tax_type

Retrieves a specific tax rate according to given TaxType code Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
TaxTypestringYesA valid TaxType code

xero_accounting_get_tax_rates

Retrieves tax rates Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
wherestringNoFilter by an any element
orderstringNoOrder by an any element

xero_accounting_get_user

Retrieves a specific user Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
UserIDstringYesUnique identifier for a User

xero_accounting_get_users

Retrieves users Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
If-Modified-SincestringNoOnly records created or modified since this timestamp will be returned
wherestringNoFilter by an any element
orderstringNoOrder by an any element

xero_accounting_post_setup

Sets the chart of accounts, the conversion date and conversion balances Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
Idempotency-KeystringNoThis allows you to safely retry requests without the risk of duplicate processing. 128 character max.
bodyobjectYesObject including an accounts array, a conversion balances array and a conversion date object in body of request

xero_accounting_update_account

Updates a chart of accounts Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
AccountIDstringYesUnique identifier for Account object
Idempotency-KeystringNoThis allows you to safely retry requests without the risk of duplicate processing. 128 character max.
Accountsobject[]NoThe accounts value

xero_accounting_update_manual_journal

Updates a specific manual journal Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
Idempotency-KeystringNoThis allows you to safely retry requests without the risk of duplicate processing. 128 character max.
ManualJournalIDstringYesUnique identifier for a ManualJournal
ManualJournalsobject[]NoManual Journals
paginationobjectNoThe pagination value
Warningsobject[]NoDisplays array of warning messages from the API

xero_accounting_update_or_create_manual_journals

Updates or creates a single manual journal Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
summarizeErrorsbooleanNoIf false return 200 OK and mix of successfully created objects and any with validation errors
Idempotency-KeystringNoThis allows you to safely retry requests without the risk of duplicate processing. 128 character max.
ManualJournalsobject[]NoManual Journals
paginationobjectNoThe pagination value
Warningsobject[]NoDisplays array of warning messages from the API

xero_accounting_update_tax_rate

Updates tax rates Parameters:
ParameterTypeRequiredDefaultDescription
xero-tenant-idstringYesXero identifier for Tenant
Idempotency-KeystringNoThis allows you to safely retry requests without the risk of duplicate processing. 128 character max.
TaxRatesobject[]NoTax Rates