Prerequisites

Before you can pre-register merchants, you need credentials from the Shopify Partner Dashboard. This is a one-time setup per merchant.

Required Access

• Shopify Partner Dashboard account with permission to create custom apps

• Access to your channel's Violet account (Channel Dashboard)

Getting Your Credentials

For each merchant you want to onboard, you'll need three pieces of information from Shopify:

1. Client ID: OAuth client identifier (identifies your app)

2. Client Secret: OAuth secret key (authenticates your app)

3. Install Link: Merchant-specific Shopify authorization URL

How to get these credentials:

1. Log in to Shopify Partner Dashboard

2. Navigate to Apps → Create an app

3. Choose Create an app and select Custom app

4. Configure the app:

   • App name: Use a descriptive name (e.g., "Your Channel Name - Merchant Name")

   • Admin API access scopes: Select required permissions (see list below)

   • Save: Click to generate credentials

5. Copy credentials immediately (before navigating away):

   • Copy the Client ID

   • Copy the Client Secret — This appears only once. If you lose it, you must regenerate it.

   • Copy the Install link

6. Immediately go to Violet Channel Dashboard and paste all three credentials into the pre-registration form while they're fresh

   • Do not wait or close Shopify without saving these values

Critical: The Client Secret can only be viewed once in Shopify. Copy all credentials immediately after creating the app, then go straight to Violet to paste them. If you navigate away or refresh without saving them, see the Troubleshooting & FAQs page for recovery steps.

Need detailed setup instructions? See the Shopify Merchant Setup Guide for step-by-step instructions on creating custom apps in the Shopify Partner Dashboard.

Store credentials securely. The Client Secret can only be viewed once. If you lose it, you must regenerate it in the Shopify Partner Dashboard. Never share credentials in plain text.

Required API Scopes

Your custom app must have the following Shopify Admin API scopes. These permissions allow Violet to access what the merchant needs:

Scope	Purpose
read_products	Access merchant's product catalog
write_orders	Create and update orders during checkout
read_customers	Read customer information
write_customers	Create customer records when completing checkout
read_inventory	Check product availability
read_locations	Access inventory location data
read_fulfillments	Track order fulfillment status
read_shipping	Calculate shipping rates
read_price_rules	Understand discount policies
read_discounts	Understand discount combinations
read_markets	Understand regions merchant ships to

Additional scopes: Your channel may require additional scopes depending on specific features. Violet will communicate these during your integration. You can always add more scopes to an existing app.

---

Next step: Go to Pre-Registration Process to learn how to register merchants in Channel Dashboard.