Apply Ecommerce Standard Chart
POST/api/ledger/setup/ecommerce-standard/apply
Apply the preview rows you selected. Only adds: creates missing accounts, fills empty roles and empty payout mappings. Nothing already set is remapped, renamed or deleted, and nothing dated in a locked period is written. Requires the accounting.manage_settings permission.
accounting:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
The preview is re-run first. If any selected row is no longer offered (for example the role was mapped since the preview), the whole request is refused with 422 and nothing is applied.
Body:
rows(required, array, min 1) — the selected rows.rows.*.id(required, string, distinct) — a rowidfrom the preview.rows.*.create_in_provider(optional, boolean, default false) — also create this account in the connected Xero / QuickBooks Online organisation and link it. Only for rows withprovider_create_available.rows.*.use_existing_id(optional, integer, nullable) — use one of the row'spossible_matchesinstead of creating the account.
Payout mapping fills take effect from effective_from; earlier payouts keep their accounts. A payout row whose account was neither existing nor added is skipped and listed in skipped. A provider failure leaves the account in SKU.io, unlinked, and is listed in provider_failed.
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 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.