Xero Node SDK

https://github.com/xeroapi/xero-node
Admin
The Xero Node SDK simplifies access to Xero's APIs for JavaScript developers, enabling the creation...
Tokens:317,416
Snippets:967
Trust Score:7.7
License:MIT
Update:1 month ago
Show doc for...
Tokens:
Raw
### Install xero-node SDK

Source: https://github.com/xeroapi/xero-node/blob/master/README.md

Use npm to install the Xero Node SDK into your project.

```bash
npm install xero-node
```

--------------------------------

### Example: Retrieve Payroll AU Payslips

Source: https://github.com/xeroapi/xero-node/blob/master/docs/payroll-au-v2/index.html

Shows how to fetch payslips from the Payroll AU API. The example uses the xero-node library and demonstrates the GET request to the payslips endpoint.

```javascript
const xero = new XeroClient({
  clientId: 'YOUR_CLIENT_ID',
  clientSecret: 'YOUR_CLIENT_SECRET',
  grantType: 'client_credentials'
});

await xero.authenticate();

const response = await xero.payrollAU.payslips.get();
console.log(response.body);
```

--------------------------------

### Example: Retrieve Payroll AU Employees

Source: https://github.com/xeroapi/xero-node/blob/master/docs/payroll-au-v2/index.html

Shows how to fetch a list of employees from the Payroll AU API. The example uses the xero-node library and demonstrates the GET request to the employees endpoint.

```javascript
const xero = new XeroClient({
  clientId: 'YOUR_CLIENT_ID',
  clientSecret: 'YOUR_CLIENT_SECRET',
  grantType: 'client_credentials'
});

await xero.authenticate();

const response = await xero.payrollAU.employees.get();
console.log(response.body);
```

--------------------------------

### Node.js SDK Usage Example

Source: https://github.com/xeroapi/xero-node/blob/master/docs/appstore/index.html

Example showing how to call postUsageRecords using the Xero Node SDK, including token setting and error handling.

```javascript
await xero.setTokenSet(tokenSet);

const subscriptionId = '00000000-0000-0000-0000-000000000000';
const subscriptionItemId = '00000000-0000-0000-0000-000000000000';
const idempotencyKey = 'KEY_VALUE';

try {
  const response = await xero.accountingApi.postUsageRecords(subscriptionId, subscriptionItemId, createUsageRecord, idempotencyKey);
  console.log(response.body || response.response.statusCode)
} catch (err) {
  const error = JSON.stringify(err.response.body, null, 2)
  console.log(`Status Code: ${err.response.statusCode} => ${error}`);
}
```

--------------------------------

### Create File Association Node.js SDK Example

Source: https://github.com/xeroapi/xero-node/blob/master/docs/files/index.html

Example usage of the createFileAssociation method using the Xero Node.js SDK, including error handling.

```javascript
await xero.setTokenSet(tokenSet);

const xeroTenantId = 'YOUR_XERO_TENANT_ID';
const fileId = '4ff1e5cc-9835-40d5-bb18-09fdb118db9c';
const idempotencyKey = 'KEY_VALUE';

try {
  const response = await xero.accountingApi.createFileAssociation(xeroTenantId, fileId, association, idempotencyKey);
  console.log(response.body || response.response.statusCode)
} catch (err) {
  const error = JSON.stringify(err.response.body, null, 2)
  console.log(`Status Code: ${err.response.statusCode} => ${error}`);
}
```

--------------------------------

### Debug Logging Setup

Source: https://github.com/xeroapi/xero-node/blob/master/docs/payroll-au-v2/index.html

Sets up debug logging for json-schema-ref-parser.

```javascript
"use strict";var debug=require("debug");module.exports=debug("json-schema-ref-parser");
```

--------------------------------

### Initialize XeroClient for App Store Subscriptions and get subscription

Source: https://github.com/xeroapi/xero-node/blob/master/README.md

Use this snippet to query App Store subscription data using the marketplace.billing scope. The client_credentials token only works for apps that have completed App Store on-boarding. The example shows a try/catch around token retrieval and logs the subscription response body.

```TypeScript
// => /post-purchase-url

const xeroAppStoreClient = new XeroClient({
  clientId: process.env.CLIENT_ID,
  clientSecret: process.env.CLIENT_SECRET,
  grantType: 'client_credentials',
  scopes: ['marketplace.billing']
});

try {
  await xeroAppStoreClient.getClientCredentialsToken()
} catch(e) {
  console.log('ERROR: ', e)
}

const subscriptionRequest = await xeroAppStoreClient.appStoreApi.getSubscription(subscripionId)

console.log(subscriptionRequest.body)
{
  currentPeriodEnd: 2021-09-02T20:08:58.772Z,
  endDate: null,
  id: '03bc74f2-1237-4477-b782-2dfb1a6d8b21',
  organisationId: '79e8b2e5-c63d-4dce-888f-e0f3e9eac647',
  plans: [
     {
      id: '6abc26f3-9390-4194-8b25-ce8b9942fda9',
      name: 'Small',
      status: 'ACTIVE',
      subscriptionItems: [
        endDate: null,
        id: '834cff4c-b753-4de2-9e7a-3451e14fa17a',
        price: {
          id: '2310de92-c7c0-4bcb-b972-fb7612177bc7',
          amount: 0.1,
          currency: 'NZD'
        },
        product: Product {
          id: '9586421f-7325-4493-bac9-d93be06a6a38',
          name: '',
          type: 'FIXED'
        },
        startDate: 2021-08-02T20:08:58.772Z,
        testMode: true

      ]
    }
  ],
  startDate: 2021-08-02T20:08:58.772Z,
  status: 'ACTIVE',
  testMode: true
}
```

--------------------------------

### Node.js SDK Example for createTimesheet

Source: https://github.com/xeroapi/xero-node/blob/master/docs/payroll-au-v2/index.html

Example using the Xero Node SDK to create a timesheet. It sets the token set, defines tenant ID, idempotency key, start and end dates, constructs a Timesheet object, and calls accountingApi.createTimesheet. The response is logged, and errors are caught and printed with status code and body.

```javascript
await xero.setTokenSet(tokenSet);

const xeroTenantId = 'xeroTenantId_example';
const idempotencyKey = 'KEY_VALUE';
const startDate = '2020-10-28'
const endDate = '2020-10-30'

const timesheet: Timesheet = { 
  payrollCalendarID: "00000000-0000-0000-0000-000000000000",
  employeeID: "00000000-0000-0000-0000-000000000000",
  startDate: startDate,
  endDate: endDate
}; 

try {
  const response = await xero.accountingApi.createTimesheet(xeroTenantId, timesheet, idempotencyKey);
  console.log(response.body || response.response.statusCode)
} catch (err) {
  const error = JSON.stringify(err.response.body, null, 2)
  console.log(`Status Code: ${err.response.statusCode} => ${error}`);
}
```

--------------------------------

### getProjects - Node.js SDK example

Source: https://github.com/xeroapi/xero-node/blob/master/docs/projects/index.html

Example code to retrieve all projects using the Xero Node SDK. Set the token set, then call xero.accountingApi.getProjects with optional filters. The response is logged or errors are caught and printed with the status code.

```javascript
await xero.setTokenSet(tokenSet);

const xeroTenantId = 'xeroTenantId_example';
const projectIds = [];
const contactID = '38400000-8cf0-11bd-b23e-10b96e4ef00d';
const states = 'states_example';
const page = 1;
const pageSize = 100;

try {
  const response = await xero.accountingApi.getProjects(xeroTenantId,  projectIds, contactID, states, page, pageSize);
  console.log(response.body || response.response.statusCode)
} catch (err) {
  const error = JSON.stringify(err.response.body, null, 2)
  console.log(`Status Code: ${err.response.statusCode} => ${error}`);
}
```

--------------------------------

### Writable State Initialization

Source: https://github.com/xeroapi/xero-node/blob/master/docs/bankfeeds/index.html

Initial setup for WritableState including objectMode configuration and dependency resolution.

```javascript
81:[function(require,module,exports){ (function (process){ "use strict";function nop(){}function WriteReq(e,t,r){this.chunk=e,this.encoding=t,this.callback=r,this.next=null}function WritableState(e,t){Duplex=Duplex||require("./_stream_duplex"),e=e||{},this.objectMode=!!e.objectMode,t instanceof Duplex&&(this.objectMode=this.objectMode||!!e.writableObjectMode);var 
```

--------------------------------

### Create Feed Connections Node.js SDK Example

Source: https://github.com/xeroapi/xero-node/blob/master/docs/bankfeeds/index.html

Example usage of the createFeedConnections method in the Xero Node.js SDK, including token setting and error handling.

```javascript
await xero.setTokenSet(tokenSet);

const xeroTenantId = 'xeroTenantId_example';
const idempotencyKey = 'KEY_VALUE';

try {
  const response = await xero.accountingApi.createFeedConnections(xeroTenantId, feedConnections, idempotencyKey);
  console.log(response.body || response.response.statusCode)
} catch (err) {
  const error = JSON.stringify(err.response.body, null, 2)
  console.log(`Status Code: ${err.response.statusCode} => ${error}`);
}
```

--------------------------------

### Create Timesheet Line - Node.js SDK Example

Source: https://github.com/xeroapi/xero-node/blob/master/docs/payroll-au-v2/index.html

Example using the Xero Node SDK to create a timesheet line. Requires a valid token set, tenant ID, timesheet ID, and idempotency key. The timesheetLine object includes date, earningsRateID, trackingItemID, and numberOfUnits. The response is logged or errors are caught and printed.

```javascript
await xero.setTokenSet(tokenSet);

const xeroTenantId = 'xeroTenantId_example';
const timesheetID = '38400000-8cf0-11bd-b23e-10b96e4ef00d';
const idempotencyKey = 'KEY_VALUE';
const date = '2020-10-28'

const timesheetLine: TimesheetLine = { 
  timesheetLineID: "00000000-0000-0000-0000-000000000000",
  date: date,
  earningsRateID: "00000000-0000-0000-0000-000000000000",
  trackingItemID: "00000000-0000-0000-0000-000000000000",
  numberOfUnits: 6
}; 

try {
  const response = await xero.accountingApi.createTimesheetLine(xeroTenantId, timesheetID, timesheetLine, idempotencyKey);
  console.log(response.body || response.response.statusCode)
} catch (err) {
  const error = JSON.stringify(err.response.body, null, 2)
  console.log(`Status Code: ${err.response.statusCode} => ${error}`);
}
```

--------------------------------

### Initialize Xero Client

Source: https://github.com/xeroapi/xero-node/blob/master/docs/projects/index.html

Create a new Xero client instance with your app credentials.

```javascript
const xero = new XeroClient({
  clientId: 'YOUR_CLIENT_ID',
  clientSecret: 'YOUR_CLIENT_SECRET',
  redirectUris: ['http://localhost:3000/callback'],
  scopes: 'openid profile email accounting.transactions offline_access'
});
```

--------------------------------

### Create a project using the Xero Node SDK

Source: https://github.com/xeroapi/xero-node/blob/master/docs/projects/index.html

Demonstrates how to create a new project using the createProject method. Requires setting the token set and providing the xeroTenantId and an optional idempotencyKey.

```javascript
await xero.setTokenSet(tokenSet);

const xeroTenantId = 'xeroTenantId_example';
const idempotencyKey = 'KEY_VALUE';

try {
  const response = await xero.accountingApi.createProject(xeroTenantId, projectCreateOrUpdate, idempotencyKey);
  console.log(response.body || response.response.statusCode)
} catch (err) {
  const error = JSON.stringify(err.response.body, null, 2)
  console.log(`Status Code: ${err.response.statusCode} => ${error}`);
}
```

--------------------------------

### Initialize Xero Client

Source: https://github.com/xeroapi/xero-node/blob/master/docs/finance/index.html

Create a new Xero client instance with your app credentials and required scopes.

```javascript
const xero = new XeroClient({
  clientId: 'YOUR_CLIENT_ID',
  clientSecret: 'YOUR_CLIENT_SECRET',
  redirectUris: ['http://localhost:3000/callback'],
  scopes: 'openid profile email accounting.transactions accounting.contacts accounting.settings offline_access'
});
```

--------------------------------

### Initialize XeroClient

Source: https://github.com/xeroapi/xero-node/blob/master/README.md

Configure the XeroClient with your credentials, redirect URIs, and requested scopes.

```javascript
import { XeroClient } from 'xero-node';

const xero = new XeroClient({
  clientId: 'YOUR_CLIENT_ID',
  clientSecret: 'YOUR_CLIENT_SECRET',
  redirectUris: [`http://localhost:${port}/callback`],
  scopes: 'openid profile email accounting.settings accounting.transactions offline_access'.split(" "),
  state: 'returnPage=my-sweet-dashboard', // custom params (optional)
  httpTimeout: 3000, // ms (optional)
  clockTolerance: 10 // seconds (optional)
});
```

--------------------------------

### Delete Task SDK Example

Source: https://github.com/xeroapi/xero-node/blob/master/docs/projects/index.html

Node.js example for deleting a task using the xero.accountingApi.deleteTask method.

```javascript
await xero.setTokenSet(tokenSet);

const xeroTenantId = 'xeroTenantId_example';
const projectId = '38400000-8cf0-11bd-b23e-10b96e4ef00d';
const taskId = '38400000-8cf0-11bd-b23e-10b96e4ef00d';

try {
  const response = await xero.accountingApi.deleteTask(xeroTenantId, projectId, taskId);
  console.log(response.body || response.response.statusCode)
} catch (err) {
  const error = JSON.stringify(err.response.body, null, 2)
  console.log(`Status Code: ${err.response.statusCode} => ${error}`);
}
```

--------------------------------

### Delete Time Entry SDK Example

Source: https://github.com/xeroapi/xero-node/blob/master/docs/projects/index.html

Node.js example for deleting a time entry using the xero.accountingApi.deleteTimeEntry method.

```javascript
await xero.setTokenSet(tokenSet);

const xeroTenantId = 'xeroTenantId_example';
const projectId = '38400000-8cf0-11bd-b23e-10b96e4ef00d';
const timeEntryId = '38400000-8cf0-11bd-b23e-10b96e4ef00d';

try {
  const response = await xero.accountingApi.deleteTimeEntry(xeroTenantId, projectId, timeEntryId);
  console.log(response.body || response.response.statusCode)
} catch (err) {
  const error = JSON.stringify(err.response.body, null, 2)
  console.log(`Status Code: ${err.response.statusCode} => ${error}`);
}
```

--------------------------------

### Buffer Module Exports and Initialization

Source: https://github.com/xeroapi/xero-node/blob/master/docs/files/index.html

Core Buffer module setup, including dependency requirements and prototype configuration.

```javascript
var base64=require("base64-js"),ieee754=require("ieee754"),isArray=require("isarray");exports.Buffer=Buffer,exports.SlowBuffer=SlowBuffer,exports.INSPECT_MAX_BYTES=50,Buffer.poolSize=8192;var rootParent={};Buffer.TYPED_ARRAY_SUPPORT=void 0!==global.TYPED_ARRAY_SUPPORT?global.TYPED_ARRAY_SUPPORT:typedArraySupport(),Buffer.TYPED_ARRAY_SUPPORT?(Buffer.prototype.__proto__=Uint8Array.prototype,Buffer.__proto__=Uint8Array):(Buffer.prototype.length=void 0,Buffer.prototype.parent=void 0)
```

--------------------------------

### patchProject Node SDK Example

Source: https://github.com/xeroapi/xero-node/blob/master/docs/projects/index.html

Example usage of the patchProject method to update an existing project, including the use of an idempotency key.

```javascript
await xero.setTokenSet(tokenSet);

const xeroTenantId = 'xeroTenantId_example';
const projectId = '38400000-8cf0-11bd-b23e-10b96e4ef00d';
const idempotencyKey = 'KEY_VALUE';

try {
  const response = await xero.accountingApi.patchProject(xeroTenantId, projectId, projectPatch, idempotencyKey);
  console.log(response.body || response.response.statusCode)
} catch (err) {
  const error = JSON.stringify(err.response.body, null, 2)
  console.log(`Status Code: ${err.response.statusCode} => ${error}`);
}
```

--------------------------------

### getTimeEntry Node SDK Example

Source: https://github.com/xeroapi/xero-node/blob/master/docs/projects/index.html

Example usage of the getTimeEntry method to retrieve a specific time entry by project and time entry ID.

```javascript
await xero.setTokenSet(tokenSet);

const xeroTenantId = 'xeroTenantId_example';
const projectId = '38400000-8cf0-11bd-b23e-10b96e4ef00d';
const timeEntryId = '38400000-8cf0-11bd-b23e-10b96e4ef00d';

try {
  const response = await xero.accountingApi.getTimeEntry(xeroTenantId, projectId, timeEntryId);
  console.log(response.body || response.response.statusCode)
} catch (err) {
  const error = JSON.stringify(err.response.body, null, 2)
  console.log(`Status Code: ${err.response.statusCode} => ${error}`);
}
```

--------------------------------

### Initialize XeroClient and perform Accounting API operations

Source: https://github.com/xeroapi/xero-node/blob/master/README.md

Demonstrates initializing the XeroClient, handling token refresh, and executing various Accounting API requests including fetching accounts, creating invoices, adding history records, and uploading attachments.

```js
import { XeroClient, HistoryRecords, Invoice } from 'xero-node';

const xero = new XeroClient({
  clientId: 'YOUR_CLIENT_ID',
  clientSecret: 'YOUR_CLIENT_SECRET',
  redirectUris: [`http://localhost:${port}/callback`],
  scopes: 'openid profile email accounting.settings accounting.transactions offline_access'.split(" ")
});

await xero.initialize();

const tokenSet = getTokenSetFromDatabase(userId); // example function name

await xero.setTokenSet(tokenSet);

if(tokenSet.expired()){
  const validTokenSet = await xero.refreshToken();
  // save the new tokenset
}

await xero.updateTenants();

const activeTenantId = xero.tenants[0].tenantId;

// GET all Accounts
const getAccountsResponse = await xero.accountingApi.getAccounts(activeTenantId);

const accountId = getAccountsResponse.body.accounts[0].accountID

// GET one Account by ID
const getAccountResponse = await xero.accountingApi.getAccount(activeTenantId, accountId);

// CREATE an Invoice
const invoices = {
  invoices: [
    {
      type: Invoice.TypeEnum.ACCREC,
      contact: {
        contactID: contactId
      },
      lineItems: [
        {
          description: "Acme Tires",
          quantity: 2.0,
          unitAmount: 20.0,
          accountCode: "500",
          taxType: "NONE",
          lineAmount: 40.0
        }
      ],
      date: "2019-03-11",
      dueDate: "2018-12-10",
      reference: "Website Design",
      status: Invoice.StatusEnum.AUTHORISED
    }
  ]
};

const createdInvoicesResponse = await xero.accountingApi.createInvoices(activeTenantId, invoices)

const invoiceId = createdInvoicesResponse.body.invoices[0].invoiceID;

// CREATE a History Record
const historyRecords: HistoryRecords = {
  historyRecords: [
    {
      details: "This is a history record"
    }
  ]
};

const createdInvoiceHistoryResponse = await xero.accountingApi.createInvoiceHistory(activeTenantId, invoiceId, historyRecords);

// CREATE Attachment
const filename = "xero-dev.png";
const pathToUpload = path.resolve(__dirname, "../public/images/xero-dev.png");
const readStream = fs.createReadStream(pathToUpload);
const contentType = mime.lookup(filename);

const accountAttachmentsResponse = await xero.accountingApi.createInvoiceAttachmentByFileName(activeTenantId, invoiceId, filename, readStream, {
  headers: {
    'Content-Type': contentType
  }
});
```

--------------------------------

### Delete Feed Connections Node.js SDK Example

Source: https://github.com/xeroapi/xero-node/blob/master/docs/bankfeeds/index.html

Example usage of the deleteFeedConnections method in the Xero Node.js SDK, including error handling.

```javascript
await xero.setTokenSet(tokenSet);

const xeroTenantId = 'xeroTenantId_example';
const idempotencyKey = 'KEY_VALUE';

try {
  const response = await xero.accountingApi.deleteFeedConnections(xeroTenantId, feedConnections, idempotencyKey);
  console.log(response.body || response.response.statusCode)
} catch (err) {
  const error = JSON.stringify(err.response.body, null, 2)
  console.log(`Status Code: ${err.response.statusCode} => ${error}`);
}
```

--------------------------------

### GET /subscriptions/{subscriptionId}/usage-records

Source: https://github.com/xeroapi/xero-node/blob/master/docs/appstore/index.html

Gets all usage records related to the subscription. This endpoint returns a list of usage records for the specified subscription.

```APIDOC
## GET /subscriptions/{subscriptionId}/usage-records

### Description
Gets all usage records related to the subscription.

### Method
GET

### Endpoint
/subscriptions/{subscriptionId}/usage-records

### Parameters
#### Path Parameters
- **subscriptionId** (uuid) - Required - Unique identifier for Subscription object

### Scopes
- marketplace.billing - Grant read-only access to fixed assets

### Request Example
```
await xero.setTokenSet(tokenSet);

const subscriptionId = '00000000-0000-0000-0000-000000000000';

try {
  const response = await xero.accountingApi.getUsageRecords(subscriptionId);
  console.log(response.body || response.response.statusCode)
} catch (err) {
  const error = JSON.stringify(err.response.body, null, 2)
  console.log(`Status Code: ${err.response.statusCode} => ${error}`);
}
```

### Response
#### Success Response (200)
- **body** - The usage records object
- **response.statusCode** - HTTP status code

#### Response Example
```
{
  "body": {},
  "response": {
    "statusCode": 200
  }
}
```
```

--------------------------------

### Create Asset via Node.js SDK

Source: https://github.com/xeroapi/xero-node/blob/master/docs/assets/index.html

Demonstrates how to add a new fixed asset to the system using the Xero Node.js SDK. Requires a valid token set and tenant ID.

```javascript
await xero.setTokenSet(tokenSet);

const xeroTenantId = 'YOUR_XERO_TENANT_ID';
const idempotencyKey = 'KEY_VALUE';

const asset: Asset = { 
  assetname: "Other Computer",
  assetnumber: "FA-00210",
  status: Asset.StatusEnum.DRAFT
}; 

try {
  const response = await xero.accountingApi.createAsset(xeroTenantId, asset, idempotencyKey);
  console.log(response.body || response.response.statusCode)
} catch (err) {
  const error = JSON.stringify(err.response.body, null, 2)
  console.log(`Status Code: ${err.response.statusCode} => ${error}`);
}
```

--------------------------------

### OAuth2 Authentication Setup

Source: https://github.com/xeroapi/xero-node/blob/master/docs/appstore/index.html

Initialize the Xero client with OAuth2 credentials and set up the token refresh mechanism.

```javascript
const xero = new XeroClient({
  clientId: 'YOUR_CLIENT_ID',
  clientSecret: 'YOUR_CLIENT_SECRET',
  redirectUris: ['http://localhost:3000/callback'],
  scopes: 'openid profile email accounting.transactions accounting.contacts offline_access'
});
```

--------------------------------

### Schema Reference Parser Initialization

Source: https://github.com/xeroapi/xero-node/blob/master/docs/projects/index.html

Initializes the schema reference parser and sets up document ready event handlers.

```javascript
var schemaWrapper = {}; schemaWrapper.definitions = Object.assign({}, defs); defsParser = new $RefParser(); defsParser.dereference(schemaWrapper).catch(function(err) { console.log(err); }); $(document).ready(function () { $('.nav-tabs-examples').find('a:first').tab('show'); $(this).scrollspy({ target: '#scrollingNav', offset: 18 }); });
```

--------------------------------

### getTimesheet Node.js example

Source: https://github.com/xeroapi/xero-node/blob/master/docs/payroll-au-v2/index.html

Retrieves a specific timesheet by its unique TimesheetID. Requires the payroll.timesheets or payroll.timesheets.read scope. The example sets the token set, defines the tenant ID and timesheet ID, and calls xero.accountingApi.getTimesheet, logging the response or error.

```javascript
await xero.setTokenSet(tokenSet);

const xeroTenantId = 'xeroTenantId_example';
const timesheetID = '38400000-8cf0-11bd-b23e-10b96e4ef00d';

try {
  const response = await xero.accountingApi.getTimesheet(xeroTenantId, timesheetID);
  console.log(response.body || response.response.statusCode)
} catch (err) {
  const error = JSON.stringify(err.response.body, null, 2)
  console.log(`Status Code: ${err.response.statusCode} => ${error}`);
}
```

--------------------------------

### Get Invoices

Source: https://github.com/xeroapi/xero-node/blob/master/docs/finance/index.html

Retrieve a list of invoices from Xero.

```javascript
const invoices = await xero.accountingApi.getInvoices(tenantId);
```

--------------------------------

### createTask Node.js SDK Usage

Source: https://github.com/xeroapi/xero-node/blob/master/docs/projects/index.html

Example demonstrating how to call the createTask method using the Xero Node SDK, including error handling.

```javascript
await xero.setTokenSet(tokenSet);

const xeroTenantId = 'xeroTenantId_example';
const projectId = '38400000-8cf0-11bd-b23e-10b96e4ef00d';
const idempotencyKey = 'KEY_VALUE';

try {
  const response = await xero.accountingApi.createTask(xeroTenantId, projectId, taskCreateOrUpdate, idempotencyKey);
  console.log(response.body || response.response.statusCode)
} catch (err) {
  const error = JSON.stringify(err.response.body, null, 2)
  console.log(`Status Code: ${err.response.statusCode} => ${error}`);
}
```

--------------------------------

### Get Invoices

Source: https://github.com/xeroapi/xero-node/blob/master/docs/projects/index.html

Retrieve a list of invoices from the accounting API.

```javascript
const response = await xero.accountingApi.getInvoices(tenantId);
console.log(response.body.invoices);
```

--------------------------------

### Initialize XeroClient and Access API Sets

Source: https://github.com/xeroapi/xero-node/blob/master/README.md

Configure the XeroClient with credentials and settings to access specific API modules like accounting, assets, and projects.

```javascript
const xero = new XeroClient({
  clientId: 'YOUR_CLIENT_ID', // required
  clientSecret: 'YOUR_CLIENT_SECRET', // required
  redirectUris: [`http://localhost:${port}/callback`], // not used for client_credentials auth flow
  grantType: 'client_credentials', // only used for client_credentials auth flow
  scopes: 'openid profile email accounting.settings accounting.transactions offline_access'.split(" "), // not used for client_credentials auth flow
  state: 'returnPage=my-sweet-dashboard', // custom params (optional), not used for client_credentials auth flow
  httpTimeout: 3000, // ms (optional)
  clockTolerance: 10 // seconds (optional)
});

xero.accountingApi
xero.assetApi
xero.projectApi
xero.filesApi
xero.payrollAUApi
xero.payrollNZApi
xero.payrollUKApi
```

--------------------------------

### Get Assets

Source: https://github.com/xeroapi/xero-node/blob/master/docs/appstore/index.html

Retrieve a list of assets from the asset API.

```javascript
const assets = await xero.assetApi.getAssets(tenantId);
```

--------------------------------

### Get Contacts

Source: https://github.com/xeroapi/xero-node/blob/master/docs/appstore/index.html

Retrieve a list of contacts from the accounting API.

```javascript
const contacts = await xero.accountingApi.getContacts(tenantId);
```
Tokens:
Raw