OpenAPI 3.1.02026-08-185681822.2 MB

d0ab3b4eb0ae

Connect

Get Shopify OAuth connect URL

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). 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 and write_content (content only; no customer or order data). Connecting the same profile to a store again refreshes the stored token in place.

get/v1/connect/shopify

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. Accepts an http(s) URL, a custom app scheme for mobile deeplinks (e.g. myapp://callback), or a relative path. 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)