Preview Bill Sync Change
POST/api/accounting/bill-sync/preview
Preview what a proposed expense bill mode and start date would do to existing expense bills, for the whole connection or for one supplier. Writes nothing.
accounting:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Every bill in scope is counted in exactly one bucket. Without supplier_id the scope is every supplier that has no rule of its own on the connection.
Request fields:
mode(required) -send,provider_ownedorsku_only.start_date(optional, Y-m-d) - the proposed start date.supplier_id(optional, integer) - preview one supplier's rule instead of the connection setting. Must be an existing supplier.connection_id(optional, integer) - defaults to the first Xero / QuickBooks connection.
Response fields:
total- expense bills in scope.already_linked- already in the provider; they stay linked.would_send- would be sent.possible_duplicates- look like a bill the provider already has; they wait for a person (see List Waiting Bill Duplicates).before_start_date- dated before the start date and left alone.not_sent- stay in SKU.io under a mode that does not send.message- the counts as one plain sentence.
Returns 422 when there is no Xero or QuickBooks connection or a field is invalid.
Authentication: Requires Bearer token. Scope: accounting (read/write). The user must hold the Manage bill sync permission (accounting.bill_sync).
Request
Responses
- 200
- 401
- 403
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Unprocessable Content
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.