v54

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-01235140905.8 KB
Accounting

Updates or creates a single manual journal

post/ManualJournals

Query parameters

summarizeErrorsboolean

If false return 200 OK and mix of successfully created objects and any with validation errors

Headers

Idempotency-Keystring

This allows you to safely retry requests without the risk of duplicate processing. 128 character max.

Request body

Example request

{
  "ManualJournals": [
    {
      "JournalLines": [
        {
          "LineAmount": -2569,
          "Description": "Coded incorrectly Office Equipment should be Computer Equipment"
        }
      ],
      "UpdatedDateUTC": "/Date(1573755038314)/",
      "StatusAttributeString": "ERROR",
      "Attachments": [
        {
          "AttachmentID": "00000000-0000-0000-0000-000000000000",
          "FileName": "xero-dev.jpg",
          "Url": "https://api.xero.com/api.xro/2.0/Accounts/da962997-a8bd-4dff-9616-01cdc199283f/Attachments/sample5.jpg",
          "MimeType": "image/jpg"
        }
      ]
    }
  ]
}

Response

Success - return response of type ManualJournals array with newly created ManualJournal

Example response

{
  "ManualJournals": [
    {
      "JournalLines": [
        {
          "LineAmount": -2569,
          "Description": "Coded incorrectly Office Equipment should be Computer Equipment"
        }
      ],
      "UpdatedDateUTC": "/Date(1573755038314)/",
      "StatusAttributeString": "ERROR",
      "Attachments": [
        {
          "AttachmentID": "00000000-0000-0000-0000-000000000000",
          "FileName": "xero-dev.jpg",
          "Url": "https://api.xero.com/api.xro/2.0/Accounts/da962997-a8bd-4dff-9616-01cdc199283f/Attachments/sample5.jpg",
          "MimeType": "image/jpg"
        }
      ]
    }
  ]
}