/xero-accounting | Type: Application | PCID required: Yes
Tools
| Tool | Description |
|---|---|
xero_accounting_create_account | Creates a new chart of accounts |
xero_accounting_create_branding_theme_payment_services | Creates a new custom payment service for a specific branding theme |
xero_accounting_create_currency | Create a new currency for a Xero organisation |
xero_accounting_create_manual_journals | Creates one or more manual journals |
xero_accounting_create_tax_rates | Creates one or more tax rates |
xero_accounting_delete_account | Deletes a chart of accounts |
xero_accounting_get_account | Retrieves a single chart of accounts by using a unique account Id |
xero_accounting_get_accounts | Retrieves the full chart of accounts |
xero_accounting_get_branding_theme | Retrieves a specific branding theme using a unique branding theme Id |
xero_accounting_get_branding_theme_payment_services | Retrieves the payment services for a specific branding theme |
xero_accounting_get_branding_themes | Retrieves all the branding themes |
xero_accounting_get_budget | Retrieves a specific budget, which includes budget lines |
xero_accounting_get_budgets | Retrieve a list of budgets |
xero_accounting_get_currencies | Retrieves currencies for your Xero organisation |
xero_accounting_get_journal | Retrieves a specific journal using a unique journal Id. |
xero_accounting_get_journal_by_number | Retrieves a specific journal using a unique journal number. |
xero_accounting_get_journals | Retrieves journals |
xero_accounting_get_manual_journal | Retrieves a specific manual journal |
xero_accounting_get_manual_journals | Retrieves manual journals |
xero_accounting_get_organisation_actions | Retrieves a list of the key actions your app has permission to perform in the connected Xero organisation. |
xero_accounting_get_organisation_cissettings | Retrieves the CIS settings for the Xero organistaion. |
xero_accounting_get_organisations | Retrieves Xero organisation details |
xero_accounting_get_report_aged_payables_by_contact | Retrieves report for aged payables by contact |
xero_accounting_get_report_aged_receivables_by_contact | Retrieves report for aged receivables by contact |
xero_accounting_get_report_balance_sheet | Retrieves report for balancesheet |
xero_accounting_get_report_bank_summary | Retrieves report for bank summary |
xero_accounting_get_report_budget_summary | Retrieves report for budget summary |
xero_accounting_get_report_executive_summary | Retrieves report for executive summary |
xero_accounting_get_report_from_id | Retrieves a specific report using a unique ReportID |
xero_accounting_get_report_profit_and_loss | Retrieves report for profit and loss |
xero_accounting_get_report_ten_ninety_nine | Retrieve reports for 1099 |
xero_accounting_get_report_trial_balance | Retrieves report for trial balance |
xero_accounting_get_reports_list | Retrieves a list of the organistaions unique reports that require a uuid to fetch |
xero_accounting_get_tax_rate_by_tax_type | Retrieves a specific tax rate according to given TaxType code |
xero_accounting_get_tax_rates | Retrieves tax rates |
xero_accounting_get_user | Retrieves a specific user |
xero_accounting_get_users | Retrieves users |
xero_accounting_post_setup | Sets the chart of accounts, the conversion date and conversion balances |
xero_accounting_update_account | Updates a chart of accounts |
xero_accounting_update_manual_journal | Updates a specific manual journal |
xero_accounting_update_or_create_manual_journals | Updates or creates a single manual journal |
xero_accounting_update_tax_rate | Updates tax rates |
xero_accounting_create_account
Creates a new chart of accounts Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
Idempotency-Key | string | No | — | This allows you to safely retry requests without the risk of duplicate processing. 128 character max. |
AccountID | string | No | — | The Xero identifier for an account – specified as a string following the endpoint name e.g. /297c2dc5-cc47-4afd-8ec8-74990b8761e9 |
AddToWatchlist | boolean | No | — | Boolean – describes whether the account is shown in the watchlist widget on the dashboard |
BankAccountNumber | string | No | — | For bank accounts only (Account Type BANK) |
BankAccountType | string | No | — | For bank accounts only. See Bank Account types |
Class | string | No | — | See Account Class Types |
Code | string | No | — | Customer defined alpha numeric account code e.g 200 or SALES (max length = 10) |
CurrencyCode | string | No | — | 3 letter alpha code for the currency – see list of currency codes |
Description | string | No | — | Description of the Account. Valid for all types of accounts except bank accounts (max length = 4000) |
EnablePaymentsToAccount | boolean | No | — | Boolean – describes whether account can have payments applied to it |
HasAttachments | boolean | No | — | boolean to indicate if an account has an attachment (read only) |
Name | string | No | — | Name of account (max length = 150) |
ReportingCode | string | No | — | Shown if set |
ReportingCodeName | string | No | — | Shown if set |
ShowInExpenseClaims | boolean | No | — | Boolean – describes whether account code is available for use with expense claims |
Status | string | No | — | Accounts with a status of ACTIVE can be updated to ARCHIVED. See Account Status Codes |
SystemAccount | string | No | — | If 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. |
TaxType | string | No | — | The tax type from taxRates |
Type | string | No | — | See Account Types |
UpdatedDateUTC | string | No | — | Last modified date UTC format |
ValidationErrors | object[] | No | — | Displays 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
Idempotency-Key | string | No | — | This allows you to safely retry requests without the risk of duplicate processing. 128 character max. |
BrandingThemeID | string | Yes | — | Unique identifier for a Branding Theme |
PaymentServices | any[] | No | — | Payment Services |
xero_accounting_create_currency
Create a new currency for a Xero organisation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
Idempotency-Key | string | No | — | This allows you to safely retry requests without the risk of duplicate processing. 128 character max. |
Code | string | No | — | 3 letter alpha code for the currency – see list of currency codes |
Description | string | No | — | Name of Currency |
xero_accounting_create_manual_journals
Creates one or more manual journals Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
summarizeErrors | boolean | No | — | If false return 200 OK and mix of successfully created objects and any with validation errors |
Idempotency-Key | string | No | — | This allows you to safely retry requests without the risk of duplicate processing. 128 character max. |
ManualJournals | object[] | No | — | Manual Journals |
pagination | object | No | — | The pagination value |
Warnings | object[] | No | — | Displays array of warning messages from the API |
xero_accounting_create_tax_rates
Creates one or more tax rates Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
Idempotency-Key | string | No | — | This allows you to safely retry requests without the risk of duplicate processing. 128 character max. |
TaxRates | object[] | No | — | Tax Rates |
xero_accounting_delete_account
Deletes a chart of accounts Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
AccountID | string | Yes | — | Unique identifier for Account object |
xero_accounting_get_account
Retrieves a single chart of accounts by using a unique account Id Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
AccountID | string | Yes | — | Unique identifier for Account object |
xero_accounting_get_accounts
Retrieves the full chart of accounts Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
If-Modified-Since | string | No | — | Only records created or modified since this timestamp will be returned |
where | string | No | — | Filter by an any element |
order | string | No | — | Order by an any element |
xero_accounting_get_branding_theme
Retrieves a specific branding theme using a unique branding theme Id Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
BrandingThemeID | string | Yes | — | Unique identifier for a Branding Theme |
xero_accounting_get_branding_theme_payment_services
Retrieves the payment services for a specific branding theme Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
BrandingThemeID | string | Yes | — | Unique identifier for a Branding Theme |
xero_accounting_get_branding_themes
Retrieves all the branding themes Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
xero_accounting_get_budget
Retrieves a specific budget, which includes budget lines Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
BudgetID | string | Yes | — | Unique identifier for Budgets |
DateTo | string | No | — | Filter by start date |
DateFrom | string | No | — | Filter by end date |
xero_accounting_get_budgets
Retrieve a list of budgets Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
IDs | string | No | — | Filter by BudgetID. Allows you to retrieve a specific individual budget. |
DateTo | string | No | — | Filter by start date |
DateFrom | string | No | — | Filter by end date |
xero_accounting_get_currencies
Retrieves currencies for your Xero organisation Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
where | string | No | — | Filter by an any element |
order | string | No | — | Order by an any element |
xero_accounting_get_journal
Retrieves a specific journal using a unique journal Id. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
JournalID | string | Yes | — | Unique identifier for a Journal |
xero_accounting_get_journal_by_number
Retrieves a specific journal using a unique journal number. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
JournalNumber | integer | Yes | — | Number of a Journal |
xero_accounting_get_journals
Retrieves journals Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
If-Modified-Since | string | No | — | Only records created or modified since this timestamp will be returned |
offset | integer | No | — | Offset by a specified journal number. e.g. journals with a JournalNumber greater than the offset will be returned |
paymentsOnly | boolean | No | — | Filter 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
ManualJournalID | string | Yes | — | Unique identifier for a ManualJournal |
xero_accounting_get_manual_journals
Retrieves manual journals Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
If-Modified-Since | string | No | — | Only records created or modified since this timestamp will be returned |
where | string | No | — | Filter by an any element |
order | string | No | — | Order by an any element |
page | integer | No | — | e.g. page=1 – Up to 100 manual journals will be returned in a single API call with line items shown for each overpayment |
pageSize | integer | No | — | Number 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
xero_accounting_get_organisation_cissettings
Retrieves the CIS settings for the Xero organistaion. Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
OrganisationID | string | Yes | — | The unique Xero identifier for an organisation |
xero_accounting_get_organisations
Retrieves Xero organisation details Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
xero_accounting_get_report_aged_payables_by_contact
Retrieves report for aged payables by contact Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
contactId | string | Yes | — | Unique identifier for a Contact |
date | string | No | — | The date of the Aged Payables By Contact report |
fromDate | string | No | — | filter by the from date of the report e.g. 2021-02-01 |
toDate | string | No | — | filter 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
contactId | string | Yes | — | Unique identifier for a Contact |
date | string | No | — | The date of the Aged Receivables By Contact report |
fromDate | string | No | — | filter by the from date of the report e.g. 2021-02-01 |
toDate | string | No | — | filter by the to date of the report e.g. 2021-02-28 |
xero_accounting_get_report_balance_sheet
Retrieves report for balancesheet Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
date | string | No | — | The date of the Balance Sheet report |
periods | integer | No | — | The number of periods for the Balance Sheet report |
timeframe | string | No | — | The period size to compare to (MONTH, QUARTER, YEAR) |
trackingOptionID1 | string | No | — | The tracking option 1 for the Balance Sheet report |
trackingOptionID2 | string | No | — | The tracking option 2 for the Balance Sheet report |
standardLayout | boolean | No | — | The standard layout boolean for the Balance Sheet report |
paymentsOnly | boolean | No | — | return a cash basis for the Balance Sheet report |
xero_accounting_get_report_bank_summary
Retrieves report for bank summary Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
fromDate | string | No | — | filter by the from date of the report e.g. 2021-02-01 |
toDate | string | No | — | filter by the to date of the report e.g. 2021-02-28 |
xero_accounting_get_report_budget_summary
Retrieves report for budget summary Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
date | string | No | — | The date for the Bank Summary report e.g. 2018-03-31 |
periods | integer | No | — | The number of periods to compare (integer between 1 and 12) |
timeframe | integer | No | — | The period size to compare to (1=month, 3=quarter, 12=year) |
xero_accounting_get_report_executive_summary
Retrieves report for executive summary Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
date | string | No | — | The 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
ReportID | string | Yes | — | Unique identifier for a Report |
xero_accounting_get_report_profit_and_loss
Retrieves report for profit and loss Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
fromDate | string | No | — | filter by the from date of the report e.g. 2021-02-01 |
toDate | string | No | — | filter by the to date of the report e.g. 2021-02-28 |
periods | integer | No | — | The number of periods to compare (integer between 1 and 12) |
timeframe | string | No | — | The period size to compare to (MONTH, QUARTER, YEAR) |
trackingCategoryID | string | No | — | The trackingCategory 1 for the ProfitAndLoss report |
trackingCategoryID2 | string | No | — | The trackingCategory 2 for the ProfitAndLoss report |
trackingOptionID | string | No | — | The tracking option 1 for the ProfitAndLoss report |
trackingOptionID2 | string | No | — | The tracking option 2 for the ProfitAndLoss report |
standardLayout | boolean | No | — | Return the standard layout for the ProfitAndLoss report |
paymentsOnly | boolean | No | — | Return cash only basis for the ProfitAndLoss report |
xero_accounting_get_report_ten_ninety_nine
Retrieve reports for 1099 Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
reportYear | string | No | — | The year of the 1099 report |
xero_accounting_get_report_trial_balance
Retrieves report for trial balance Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
date | string | No | — | The date for the Trial Balance report e.g. 2018-03-31 |
paymentsOnly | boolean | No | — | Return 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
xero_accounting_get_tax_rate_by_tax_type
Retrieves a specific tax rate according to given TaxType code Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
TaxType | string | Yes | — | A valid TaxType code |
xero_accounting_get_tax_rates
Retrieves tax rates Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
where | string | No | — | Filter by an any element |
order | string | No | — | Order by an any element |
xero_accounting_get_user
Retrieves a specific user Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
UserID | string | Yes | — | Unique identifier for a User |
xero_accounting_get_users
Retrieves users Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
If-Modified-Since | string | No | — | Only records created or modified since this timestamp will be returned |
where | string | No | — | Filter by an any element |
order | string | No | — | Order by an any element |
xero_accounting_post_setup
Sets the chart of accounts, the conversion date and conversion balances Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
Idempotency-Key | string | No | — | This allows you to safely retry requests without the risk of duplicate processing. 128 character max. |
body | object | Yes | — | Object 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:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
AccountID | string | Yes | — | Unique identifier for Account object |
Idempotency-Key | string | No | — | This allows you to safely retry requests without the risk of duplicate processing. 128 character max. |
Accounts | object[] | No | — | The accounts value |
xero_accounting_update_manual_journal
Updates a specific manual journal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
Idempotency-Key | string | No | — | This allows you to safely retry requests without the risk of duplicate processing. 128 character max. |
ManualJournalID | string | Yes | — | Unique identifier for a ManualJournal |
ManualJournals | object[] | No | — | Manual Journals |
pagination | object | No | — | The pagination value |
Warnings | object[] | No | — | Displays array of warning messages from the API |
xero_accounting_update_or_create_manual_journals
Updates or creates a single manual journal Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
summarizeErrors | boolean | No | — | If false return 200 OK and mix of successfully created objects and any with validation errors |
Idempotency-Key | string | No | — | This allows you to safely retry requests without the risk of duplicate processing. 128 character max. |
ManualJournals | object[] | No | — | Manual Journals |
pagination | object | No | — | The pagination value |
Warnings | object[] | No | — | Displays array of warning messages from the API |
xero_accounting_update_tax_rate
Updates tax rates Parameters:| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
xero-tenant-id | string | Yes | — | Xero identifier for Tenant |
Idempotency-Key | string | No | — | This allows you to safely retry requests without the risk of duplicate processing. 128 character max. |
TaxRates | object[] | No | — | Tax Rates |

