Connect

Get Shopify OAuth connect URL

Changed on

Initiate the Shopify OAuth flow for a store. Shopify is a connect-only platform: the connected account does not publish social posts, it powers the Blogs API (/v1/accounts/{accountId}/blogs) and the Products API (/v1/accounts/{accountId}/products). Returns an authUrl to redirect the merchant to; after they approve the install, Shopify redirects their browser to Zernio's callback, the account is created on the profile (platform shopify), and the browser is redirected to redirect_url (or the Zernio dashboard when omitted). Requested scopes are read_content, write_content, read_products and write_products (content and products only; no customer or order data). Connecting the same profile to a store again refreshes the stored token in place, and is how a store connected under the older content-only grant picks up product access.

get/v1/connect/shopify

Request

  • Base URL: https://zernio.com/api
  • URL: https://zernio.com/api/v1/connect/shopify
  • Auth: HTTP bearer

Query parameters

profileIdstring required

Your Zernio profile ID (get from /v1/profiles).

shopstring required

The myshopify.com store domain to connect, e.g. your-store.myshopify.com (the bare your-store prefix is accepted too).

redirect_urlstring uri

Your custom redirect URL after connection completes. MUST be an absolute http(s) URL or a custom app scheme for mobile deeplinks (e.g. myapp://callback); a relative path is rejected with 400 INVALID_REDIRECT_URL. On failure an error query param is appended.

Response

OAuth authorization URL to redirect the merchant to

authUrlstring uri

URL to redirect your user to for OAuth authorization

statestring

State parameter for security (handled automatically)

Changes

    • warning

      added the new account enum value to the / response property for the response status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status