How to connect Shopify to Koala AI
Koala AI publishes to your Shopify blog through a custom app that you create in your Shopify Dev Dashboard. You paste the app's Client ID and Client secret into Koala AI, then choose the blog, author and post status for new articles. Setup takes about 10 minutes.
Step 1: Create the app in Shopify
- In your Shopify admin, go to Settings.
- At the top left of the sidebar, copy your store's .myshopify.com address (for example
tsq108-pt.myshopify.com). This is your Store Name in Koala AI. Your custom domain won't work here. - Open the Apps page.
- Click Develop apps, then Build apps in Dev Dashboard.
- Click Create app, enter a name (we recommend Koala AI), then click Create.
- Under Scopes, add write_content. Leave everything else as it is.
- Uncheck Embed app in Shopify admin.
- Click Release at the bottom of the page, then click Release again in the confirmation.
- Open the app's Settings in the left sidebar and copy the Client ID and Client secret.
- Click your app's name, then Install app. Select your store and click Install. You can close the tab Shopify opens afterwards.
Step 2: Connect the store in Koala AI
- Go to your Account page and scroll to Integrations.
- Click Connect next to Shopify.
- Paste your Store Name, Client ID and Client Secret.
- Click Connect Shopify.
When the connection succeeds, the Shopify Settings window opens:
- Blog: the blog new posts go to. If you created a blog in Shopify a moment ago, click Refresh. If your store has no blog yet, Koala AI creates one called "Blog posts" and selects it.
- Author: the name shown as the post's author. Leave it blank to use the store default.
- Post Status: Draft (the default) or Published.
Click Save Settings. To change them later, click the pencil icon (Edit Settings) on the store's row under Connected Integrations.
Connecting the same store again (for example with a new Client secret) updates the existing connection and keeps your blog choice.
Step 3: Publish an article
- Open a finished article in KoalaWriter.
- Click Create Draft above the article. If you have more than one integration, pick your Shopify store from the list.
- In the Publish to Shopify window, check the Blog, Author and Post Status. Click Save as default if you want these choices next time.
- Click Create Draft. The post opens in your Shopify admin in a new tab.
To send every new article to Shopify without clicking, see How to automatically upload articles to your website.
Troubleshooting
"Shopify returned HTTP 403 ... This action requires merchant approval for write_content scope"
The app installed on your store doesn't have the write_content permission approved. This happens when the scope was added after the app was installed, or when the version with the scope was never released.
- Open the app in your Dev Dashboard and check that write_content is listed under Scopes. Add it if it's missing.
- Click Release to release that version.
- Install the app on your store again and approve the permissions Shopify asks for.
- On your Koala AI Account page, click Connect next to Shopify, enter the same Store Name, Client ID and Client secret, and click Connect Shopify. This refreshes the connection.
"Couldn't connect with those credentials"
Check three things: the Store Name is your .myshopify.com address, the Client ID and Client secret come from the app's Settings page, and the app is installed on your store (step 10 above).
Opening the app in Shopify admin redirects to example.com
Koala AI doesn't use the app's page inside Shopify, so you can ignore this. Close the tab; publishing works without it.
"Your Shopify connection has expired. Please reconnect your store."
Koala AI couldn't get a new access token from Shopify. This happens when the app was uninstalled or its Client secret changed. Reinstall the app if needed, then connect again with the current Client ID and Client secret.
Still stuck? Contact us through the chat on koala.sh or email hello@koala.sh with the full error message.
Updated on: 09/11/2026
Thank you!