← Back to App

Documentation

Shopify API Setup Guide

Complete step-by-step guide to setting up Shopify API access for seamless blog publishing directly from Intelliblog to your Shopify store.

Prerequisites

  • Active Shopify store with admin access
  • Shopify plan that supports private apps (Basic Shopify or higher)
  • At least one blog created in your Shopify store
1

Access Shopify Admin

Start by logging into your Shopify store admin panel.

  1. Navigate to your Shopify store URL: your-store-name.myshopify.com/admin
  2. Log in with your admin credentials
  3. Ensure you have admin or staff permissions to create apps
Note:

Only store owners and staff with "Apps and channels" permissions can create private apps.

2

Navigate to App Development

Access the app development section in your Shopify admin.

  1. In the Shopify admin, go to Settings (bottom left)
  2. Click on Apps and sales channels
  3. Look for Develop apps or Manage private apps
  4. If you see "Allow custom app development", click it first

Different Shopify Versions:

Newer Shopify Interface:

Settings → Apps and sales channels → Develop apps

Older Shopify Interface:

Settings → Apps → Manage private apps

3

Create a Private App

Create a new private app specifically for Intelliblog blog publishing.

  1. Click "Create an app" or "Create private app"
  2. Fill in the app details:
    • App name: "Intelliblog Publisher" (or any name you prefer)
    • App developer: Your name or company
    • Developer email: Your email address
  3. Click "Create app"

💡 Tip: Use a descriptive name like "Intelliblog Publisher" so you can easily identify this app later if you have multiple private apps.

4

Configure API Scopes

Set up the specific permissions needed for blog publishing.

  1. In your new app, click on "Configuration"
  2. Scroll down to "Admin API access scopes"
  3. Enable these specific scopes:
    Required Scopes:
    read_content - Read blogs and articles
    write_content - Create and edit blog posts
  4. Leave other scopes unchecked for security
  5. Click "Save"
Security Best Practice:

Only enable the minimum required scopes. Avoid enabling broader permissions like "read_products" or "write_orders" unless specifically needed.

5

Install the App & Get Access Token

Install your private app to generate the access token.

  1. Click "Install app" button
  2. Review the permissions and confirm installation
  3. Once installed, you'll see the "Admin API access token"
  4. Click "Reveal token once" to display it
  5. Copy the token immediately (starts with shpat_)
⚠️ Critical: Save Your Token Immediately!

Shopify will only show this token once. If you lose it, you'll need to regenerate a new one. Save it securely - treat it like a password!

Example Token Format:
shpat_1234567890abcdef1234567890abcdef
6

Get Your Store Domain

Identify your store's domain for API access.

Your Shopify store domain follows this format:

Store Domain Format:
your-store-name.myshopify.com
How to Find Your .myshopify.com Domain:
  • Method 1: Look at your Shopify admin URL in browser
  • Method 2: Settings → General → Store details
  • Method 3: Settings → Domains (shows primary domain)
  • • It's always in the format: [store-name].myshopify.com

Important for Custom Domain Users: Even if you have a custom domain (like mystore.com), you MUST use the .myshopify.com domain for API access. Your custom domain won't work with the API.

Example: If your store is mystore.com, you still need my-store.myshopify.com for the API.

7

Configure Intelliblog

Add your Shopify credentials to Intelliblog.

  1. In Intelliblog, go to AdminPlatforms
  2. Find Shopify in the platform list
  3. Click "Add Platform" or the "+" button
  4. Fill in the required fields:
    your-store-name.myshopify.com

    Include the full .myshopify.com domain

    shpat_your_actual_token_here

    The private app access token you copied

  5. Click "Test Connection" to verify
  6. Click "Save" when the test succeeds
Success!

Once configured, you'll be able to publish blog posts directly to your Shopify store with draft status for review before going live.

🔧 Troubleshooting

Error: "Invalid credentials"

  • • Double-check your access token (starts with "shpat_")
  • • Verify your domain includes ".myshopify.com"
  • • Ensure the private app is installed

Error: "Insufficient permissions"

  • • Check that "read_content" and "write_content" scopes are enabled
  • • Reinstall the app if you changed permissions
  • • Verify you're a store owner or have app creation permissions

Error: "No blogs found"

  • • Create at least one blog in Shopify: Online Store → Blog posts → Manage blogs
  • • Wait a few minutes for the blog to be available via API
  • • Refresh the connection test in Intelliblog

🔒 Security Best Practices

Token Security

  • • Never share your access token publicly
  • • Store it securely (password manager recommended)
  • • Regenerate if you suspect it's compromised
  • • Only use HTTPS connections

Permission Management

  • • Only enable necessary API scopes
  • • Review app permissions regularly
  • • Remove unused private apps
  • • Monitor API usage in Shopify analytics

Need Additional Help?

Having trouble with your Shopify setup? We're here to help you get publishing.