Set Channel Accounting Owner
PUT/api/ledger/settings/channel-sync/:integrationInstance/owner
Sets who books one sales channel in the accounting system. Use it when another app (for example A2X, Link My Books, Synder, or a bookkeeper) already books part of the channel, so SKU.io must not send the same documents.
accounting:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
Authentication: Requires Bearer token with the Manage accounting settings permission.
Body:
owner(string, required):sku(SKU.io books the channel),external_revenue(another app books revenue, refunds and payout/settlement documents; SKU.io keeps sending COGS and inventory journals) orexternal_all(another app books everything for the channel).app_name(string, optional, max 60): the other app's name, used only as a label ("Booked by A2X"). Ignored whenownerissku.send_from_today(boolean, optional): when documents come back to SKU.io — the channel returns tosku, orexternal_allnarrows toexternal_revenue(COGS and returns come back). Documents the other app booked that are dated before today then stay unsent automatically (they can still be pushed one at a time), so SKU.io does not send a period twice. A save that keeps the same owner (e.g. only renaming the app) changes nothing.
Documents the other app books are never sent by SKU.io — not automatically and not with Sync Now. Documents already in the accounting system are never changed or removed. The channel's unsynced documents are re-evaluated in the background.
Returns the channel's refreshed explanation (same shape as Get Channel Sync Explanation). 404 when the channel does not exist; 422 for an invalid owner, an app name over 60 characters, or an instance that is not a sales channel.
Request
Responses
- 200
- 401
- 403
- 404
- 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.
Not Found
Response Headers
Unprocessable Entity
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.