Reference · built on requestConnectorERP & finance

MYOB Business

Contacts, invoices, bills, inventory items, and general ledger accounts from MYOB Business, AccountRight, and Essentials company files.

About

MYOB Business is accounting software for businesses in Australia and New Zealand. The MYOB Business API is one interface for AccountRight, new Essentials, and MYOB Business company files. It exposes contacts, sales, purchases, inventory items, banking, payroll, and the general ledger as JSON over HTTPS, and each company file is addressed by its own URI under api.myob.com/accountright.

An operator on Fibric reads open invoices, unpaid bills, and item quantities, then proposes a customer payment, a purchase bill, or an inventory adjustment for your approval. Each proposal carries a receipt: what changed, why, and how to undo it.

This is a reference listing. It documents what Fibric would read from MYOB Business and what it could propose, based on the vendor's published interfaces. Fibric builds it under a managed deployment when you request it; selecting it here installs nothing.

Inputs

  • Contacts of every type through /Contact, with If-Modified-Since for change detection
  • Sales invoices, orders, and quotes in Item, Service, Professional, TimeBilling, and Miscellaneous layouts, each with Status and BalanceDueAmount
  • Customer payments, credit refunds, and credit settlements under /Sale
  • Purchase orders, bills with attachments, supplier payments, and debit refunds under /Purchase
  • Inventory items with QuantityOnHand, QuantityCommitted, QuantityOnOrder, QuantityAvailable, and AverageCost
  • General ledger accounts, the account register, journal transactions, tax codes, jobs, and categories
  • Company details, including the serial number prefix that marks a file as AU or NZ

Proposed actions

  • Target capability: propose a sales invoice or sales order through /Sale/Invoice or /Sale/Order
  • Target capability: propose recording a customer payment, with discounts and fees calculated by MYOB first
  • Target capability: propose a purchase order or a supplier bill under /Purchase
  • Target capability: propose an inventory adjustment or an item update through /Inventory
  • Target capability: propose a contact update, sent with the record's current RowVersion

Proposed actions are target capabilities. Every action runs propose-first and needs a validated deployment and the appropriate permissions.

What you can build

  • Chase overdue invoices on a schedule

    Read invoices whose Status is Open and whose BalanceDueAmount is above zero, then propose the reminder sequence and the note to record against each one.

    With Dunning Cadence

  • Apply a receipt to the right invoice

    Match a bank receipt to open invoices and propose the CustomerPayment record, with discounts and fees calculated by MYOB before anything is written.

    With Cash Application

  • Hold a sale that would breach a credit limit

    MYOB returns a CreditLimitExceeded warning on a sale. Surface it before the order is confirmed and propose the hold and the message to the customer.

    With Credit Hold

  • Match a bill to its purchase order

    Compare a supplier bill against the purchase order and the items received, then propose approval, a short-pay, or a query to the supplier.

    With Three-Way Match, Receipt Not Invoiced

Requirements

  • An MYOB Business, AccountRight, or new Essentials company file reachable at api.myob.com/accountright
  • API access granted by MYOB after you submit an application, then an API key and secret from the my.MYOB portal
  • Only the sme- scopes the work needs, such as sme-sales, sme-purchases, sme-inventory, and sme-contacts-customer
  • A company file user whose credentials go in the x-myobapi-cftoken header
Authentication
OAuth 2.0 through an app registered in the my.MYOB portal, plus an x-myobapi-key header and an x-myobapi-cftoken header carrying Base64 company file credentials.

Limits

  • Access tokens expire after 1200 seconds, so unattended reads depend on refresh tokens
  • Pages return 400 records by default and 1000 at most; $filter supports only the Eq and Gt operators
  • MYOB enforces daily and per-second call limits and answers RateLimitError; the numbers are not published on the pages this listing cites
  • No webhooks are documented; change detection relies on polling, ETags, and If-Modified-Since on contacts

Access and pricing

Reference listing. Fibric builds the connector under a managed deployment when you request it. Your quote covers the build, capabilities, usage, and support.

Request MYOB Business ↗

Questions and answers

Which MYOB products does the MYOB Business API cover?
AccountRight, new Essentials, and MYOB Business company files, through one API at api.myob.com/accountright. MYOB notes that not every feature is displayed in the product for new Essentials and AccountRight Browser, and the contact photo endpoint is available only on AccountRight.
How does the API handle concurrent edits?
Every record carries a RowVersion. A PUT must send the current value. If it is stale, MYOB answers 409 with IncorrectRowVersionSupplied, so the record is re-read before a proposal is sent again.
Does the MYOB Business API send webhooks?
Not on the pages this listing cites. Reads use $filter and $orderby, follow NextPageLink for paging, and send If-None-Match with the last ETag so an unchanged resource costs little.
Ask about MYOB Business

Ask about the capabilities and requirements in this listing.

For project-specific requirements, contact Fibric.