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).
accounting:writeGrant 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) orinvoiced_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
- 201
- 401
- 403
- 404
- 422
- 429
Created
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 — no record with the given identifier (or the route does not exist). Verify the ID before retrying.
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.