Get Authorization URL

GET 
/api/shopify/:integrationInstance/authorization-url

Returns the Shopify OAuth authorization URL for an integration instance. The frontend redirects the merchant's browser to this URL to begin authorization.

Authorization

Any valid API token can call this endpoint — no specific scope required. Manage tokens.

Authentication: Requires Bearer token.

Path params:

• integrationInstance (int, required): the integration instance id.

Notes:

• Requires connection_settings.url (or legacy shop_url) to be set on the instance.
• Uses per-instance credentials in custom-app mode, otherwise SKU.io's central public-app Client ID.
• A tenant-aware state is generated so the central-domain callback can rehydrate tenancy.

Request

Responses

200

OK

Response Headers

Content-Type

401

Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.

403

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.

404

Not found — no record with the given identifier (or the route does not exist). Verify the ID before retrying.

429

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.