Skip to main content

Create Payout Setup Account

POST 

/api/shopify/:integrationInstance/payout-accounting-setup/accounts

Creates a suggested clearing account and sets it on the store, then returns the refreshed setup status (same shape as Get Payout Accounting Setup).

Required scope: accounting:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

If an account with the suggested name already exists it is reused instead of creating a duplicate. Otherwise the account is created as a Current Asset in your connected accounting system first (QuickBooks Online: Other Current Asset; Xero: CURRENT, with a code free in both charts) and linked to a new SKU.io account. Its code is the QuickBooks account number when the company uses them, otherwise the first free code from 112 / 1120 / 1210 (113 / 1130 / 1220 for invoiced orders). Xero always gets that code. With no accounting system connected it is created in SKU.io only.

If QuickBooks or Xero refuses the account, nothing is created and a 422 explains why.

Authentication: Requires Bearer token. Requires the integrations.update and nominal_codes.create permissions.

Body:

  • account (required, string) — payments_clearing (the Shopify Payments clearing account) or invoiced_orders_clearing (the account for invoiced orders paid through payouts). The revenue and expense fallbacks are chosen from your own accounts with Update Payout Finance Settings.

Request​

Responses​

Created

Response Headers
    Content-Type