Setting Up a Webhook Between Shopify and Atomic Seller

betterdocs-category-icon

Shipping

37

Objective #

This procedure explains how to configure automatic event notifications between your Shopify store and Atomic Seller using a webhook.

With this setup, your order data is automatically and instantly sent to Atomic Seller for processing.

Prerequisites #

To complete this integration, you will need to:

  • Create a Shopify API access and retrieve:
    • the API URL
    • the access token
  • Fill in the required fields in your Atomic Seller account
  • Define an order reference suffix
  • Create two webhooks in Shopify

1. Create Shopify API Access #

Steps #

  1. Go to your Shopify Settings (bottom-left of the dashboard)
  2. Click Apps and sales channels
  3. Select Develop apps
  4. Click Create an app
  5. Name your app (e.g., Atomic Seller) and confirm

Configure API permissions #

  1. Open the Configuration tab
  2. In the Admin API integration section, click Configure
  3. In the search field, type order
  4. Select all related permissions
  5. Click Save

Retrieve the access token #

  1. Go to the API credentials tab
  2. Click Install app
  3. Click Reveal token
  4. Copy and store the token securely
    ⚠️ This token will not be visible again

2. Retrieve the API URL #

The Shopify API URL follows this format:

https://yourstore/admin/api/2025-01/orders.json

To find your store domain: #

  1. In Shopify settings, click Domains
  2. Select the domain in the format xxxxx.myshopify.com
  3. Copy this domain
  4. Replace yourstore in the API URL with your domain

Example:

https://25et7c-0c.myshopify.com/admin/api/2025-01/orders.json

3. Configure Your Store in Atomic Seller #

In your Atomic Seller account, fill in the following fields:

  • Store API URL: the API URL retrieved earlier
  • Token: your API access token
  • Replace address: set to NO

4. Define an Order Reference Suffix #

Concept #

An order reference consists of:

  • a prefix (e.g., #)
  • an order number (e.g., 1002)
  • a suffix (e.g., MYSTORE)

Example: #1002MYSTORE

The suffix allows Atomic Seller to uniquely identify your store.

Configuration #

  1. Go to Shopify Settings
  2. Open the General section
  3. In the Order ID format block, locate the Suffix field
  4. Enter a short, clear identifier for your store
  5. Provide this suffix to Atomic Seller

5. Create Webhooks #

You need to create two webhooks:

  • Order creation
  • Order update

How it works #

  • When a customer places an order, a notification is automatically sent to Atomic Seller
  • If the order is modified (by you or the customer), an update notification is also sent

Setup steps #

  1. Go to Shopify Settings
  2. Click Notifications
  3. Scroll down to the Webhooks section
  4. Click Create webhook

First webhook configuration #

  • Event: Order creation
  • Format: JSON
  • URL:https://ws2.atomicseller.com/Api/WebHook/ShopifyOrder
  • Webhook API version: latest available
  • Click Save

Second webhook configuration #

Repeat the same steps, but select:

  • Event: Order update

Completion #

Your integration is now ready for testing. Remember to validate that everything works by testing with your logistics provider before considering it operational.

From now on:

  • Every new order is automatically sent to Atomic Seller
  • All required data is transmitted instantly for processing