Skip to main content

Connecting Your Shopify Backend to Kickbite

Step-by-step guide to connecting your Shopify store to Kickbite — market config, shipping country mapping, and API integration with the correct scopes.

Written by Juan Garzon

Overview

Connecting your Shopify backend to Kickbite involves three steps in the onboarding wizard: configuring your markets, mapping shipping countries, and creating an API connection.

Step 1: Market Configuration

Define your markets by mapping URL patterns from your Shopify store. For each market:

  1. Copy your domain/subdomain URLs from Shopify (e.g., yourshop.com/de, yourshop.com/en)

  2. Select a market identifier (up to 3 letters, e.g., "DE", "INT")

  3. Set one market as the default market

  4. Choose the currency and timezone for each market

Step 2: Shipping Country Mapping

After defining markets by URL, you need to tell Kickbite how to assign backend orders to the correct market using shipping country rules.

For each market, set an include or exclude rule:

  • Include rule: Only orders shipped to the selected countries go to this market

  • Exclude rule: All orders EXCEPT those shipped to the selected countries go to this market

Example:

Market

Rule

Shipping Countries

DE

Include

DE, AT, CH

INT (default)

Include

US, AU

Tip: Any shipping country you don't explicitly assign will automatically go to your default market. You won't lose any orders.

Consider edge cases like Swiss orders (CH) — should they go to your DE/DACH market or the international market? This depends on your marketing strategy.

Step 3: Shopify API Integration

You need to create a custom app in Shopify so Kickbite can read your order data. Follow these steps:

  1. Open your Shopify Admin Panel

  2. Go to Settings → Apps

  3. Click Develop Apps to open the Dev Dashboard

  4. Click Create App and give it a recognizable name (e.g., "Kickbite")

  5. After creation, scroll down to Access and click Select Scopes

  6. Under Admin API, grant these 5 read permissions:

    • Read Orders (from the Orders section)

    • Read Product Listings (from the Listings section)

    • Read Products (from Products, Inventory and Returns)

    • Read Inventory

    • Read Returns

  7. Click Done, then click Release (leave other fields empty)

  8. Go to the app's home screen and click Install App → select your store → confirm

  9. Copy three pieces of information:

    • Client ID

    • Client Secret (found in Settings)

    • Admin Panel URL (from the browser address bar)

  10. Return to the Kickbite onboarding wizard and paste all three values

  11. Review the overview (market config, shipping codes, API details) and click Confirm

Important: Select only "Read Orders" — do NOT select "All Orders." Kickbite only needs read-only access and never writes to your Shopify backend.

Need Help?

If you run into issues connecting your Shopify backend, reach out via the in-app chat or contact your Customer Success Manager.

Did this answer your question?