Loading
Upcoming Mandatory Changes to Public Key Infrastructure (PKI)Read More
Salesforce Enforces New Security Requirements in Summer 2026Read More

MuleSoft Composer Xero Connector: Tracking Categories Missing in Create or Update Invoice Action

Publish Date: Jun 9, 2026
Description

PROBLEM:

When using the MuleSoft Composer Xero Connector, you observe that Xero Tracking Categories are not available or cannot be mapped within the "Create or Update Invoice" action. The tracking fields are not visible in the interface or in the "Select Additional Fields" menu when configuring the action.

ROOT CAUSE:

This behavior is a known limitation of the MuleSoft Composer Xero Connector. The "Create or Update Invoice" action is designed to support only direct columns within the Invoice entity. Tracking Categories are considered indirect or nested objects associated with the Invoice, rather than direct fields, and are therefore not exposed or supported by this specific action.

This limitation is documented in the MuleSoft Composer Xero Connector reference guide (https://docs.mulesoft.com/composer-salesforce/ms_composer_xero_reference):
"Creates or updates an invoice record. Only direct columns within Invoice are supported."

Resolution

Workaround: To include Tracking Categories when creating or updating Xero invoices, you must bypass the standard "Create or Update Invoice" action and directly interact with the Xero REST API using the HTTP Connector.

 

  1. Identify the Xero REST API Endpoint: Consult the official Xero API documentation to find the specific endpoint for creating or updating invoices, including how to structure the payload for Tracking Categories.
  2. Configure an HTTP Connector: In your MuleSoft Composer flow, add an HTTP Connector.
  3. Set HTTP Method and URL: Configure the HTTP Connector to use the appropriate HTTP method (e.g., POST or PUT) and the Xero API endpoint URL identified in step 1.
  4. Construct the Request Body: Create the request body (payload) in JSON or XML format, ensuring it includes all necessary invoice details and the Tracking Category data as required by the Xero API. You will need to map your source data to this structure.
  5. Add Authentication: Configure the HTTP Connector with the necessary authentication details for accessing the Xero API (e.g., OAuth 2.0).
  6. Handle Responses: Implement logic to handle the responses from the Xero API call, including success and error scenarios.
Knowledge Article Number

005386540

 
Loading
Salesforce Help | Article