Installation
This guide walks you through installing PromoSync and connecting it to your PSRESTful API account.
Prerequisites
Before installing PromoSync, you’ll need:
- A Shopify Store - PromoSync works with all Shopify plans
- A PSRESTful API Account - Sign up at psrestful.com if you don’t have one
- API Key - Generate an API key from your PSRESTful dashboard
Your PSRESTful plan determines the number of API calls available to your account.
Installing from Shopify App Store
- Visit the PromoSync listing on the Shopify App Store
- Click Add app to begin installation
- Review the permissions and click Install app
- You’ll be redirected to PromoSync’s setup wizard
Connecting Your API Key
After installation, the app will automatically connect to PSRESTful. If you are still experiencing issues, verify that the API key provided is correct.
Step 1: Get Your API Key
- Log in to your PSRESTful dashboard
- Navigate to API Keys section
- Click Generate New Key or copy an existing key
- Keep this key secure - it provides access to your supplier data
Step 2: Enter Your API Key
- In PromoSync, click Settings in the navigation
- Find the API Configuration section
- Paste your API key into the PSRESTful API Key field
Initial Configuration
After connecting your API key, configure these essential settings:
Pricing Strategy
Choose how pricing is calculated for imported products:
| Strategy | Description |
|---|---|
| MQ | Minimum Quantity pricing - uses the lowest tier |
| HUNDREDS | Price per 100 units |
| MAP | Manufacturer’s Advertised Price |
| MDP | Apply your own markup/discount rules |
See Pricing Settings for detailed configuration.
If your pricing strategy cannot be mapped to one of the options above, contact us to discuss custom pricing logic. A one-time fee applies for custom implementations.
Inventory Location
Select which Shopify location should receive inventory updates:
- Go to Settings > Inventory
- Select your primary location from the dropdown
- Optionally enable multi-location sync for advanced setups
Multi-location sync is currently in Beta.
See Inventory Settings for more details.
Product Import Defaults
Configure default settings for product imports:
- Title Format - How product titles are generated
- SKU Strategy - How SKUs are created for variants
- Variant Grouping - How product variants are organized
See Product Import Settings for all options.
Verifying Your Setup
To verify PromoSync is properly configured:
- Navigate to Products in PromoSync
- Click Import Products
- Search for any product (e.g., “t-shirt”)
- Preview a product to verify:
- Images load correctly
- Pricing displays properly
- Inventory shows available
If you see product data, your setup is complete.
Troubleshooting
API Key Issues
| Problem | Solution |
|---|---|
| ”Invalid API key” | Verify the key was copied correctly without extra spaces |
| ”API key expired” | Generate a new key from your PSRESTful dashboard |
| ”Rate limit exceeded” | Wait a few minutes before retrying |
| ”Unauthorized” | Check your PSRESTful subscription is active |
Connection Issues
If PromoSync cannot connect to the PSRESTful API:
- Check your internet connection
- Verify the API key is valid in your PSRESTful dashboard
- Ensure your PSRESTful subscription is active
- Try refreshing the page and reconnecting
Getting Help
If you continue to experience issues:
- Review the PSRESTful API documentation
- Review the PSRESTful API reference
- Contact support through the Shopify App Store listing
- Contact PSRESTful support
Next Steps
Once installation is complete:
- Configure your settings - Set up pricing, inventory, and import preferences
- Import your first products - Learn how to find and import products
- Explore features - Discover all PromoSync capabilities