Ingram Micro Integration Setup Guide
Connect your Ingram Micro reseller account to Scopable and pull real-time product catalog, pricing, availability, quotes, orders, and more.
Prerequisites
- Active Ingram Micro reseller account in good standing
- Your Ingram Micro Customer Number (format: XX-XXXXXX)
- A Scopable account with admin permissions
- About 10 minutes for setup (approval takes 2-4 business days)
You do not need to know how to code. You do not need to understand APIs. You are just creating credentials that let Scopable pull your catalog, pricing, and order data on your behalf.
Step 1: Create Your Ingram Micro Developer Account
This sounds more intimidating than it is. You are basically registering for API access.
- Go to https://developer.ingrammicro.com
- Click Sign Up at the top of the page
- Fill in the form using the email associated with your Ingram Micro reseller account
- Enter your Ingram Micro Customer Number when asked — this links your developer account to your reseller account
- Complete the registration
Once registered, Ingram gives you a sandbox app automatically. Ignore it. You need a production app.
Important: Ingram only allows one developer account per reseller. If someone at your company already registered, use that account. You cannot create a second one with a different email.
Step 2: Create a Production App
This is where you tell Ingram which APIs you want access to.
- In the developer portal, go to My Apps
- Click Create New App (or similar button to register a production app)
- Give it a name — something like "Scopable Integration" works
- In the description, write: "Third-party app Scopable will use this to query product catalog, pricing, availability, quotes, orders, invoices, and renewals."
Enable These API Products
When the form asks which APIs your app needs access to, enable all of the following:
- Product Catalog (v6)
- Price and Availability (v6)
- Orders (v6 / v7)
- Quotes (v6)
- Invoices (v6)
- Renewals (v6)
- Deals (v6)
- Returns (v6)
- Freight Estimate (v6)
Enable all of them. Even if you do not think you need invoices or renewals right now, Scopable uses them. Requesting access later means another approval cycle.
Important: Make sure "Async Order Management v7" is unchecked. If this box is checked, Ingram will require a Destination URL (Webhook URL) before you can submit the app. Scopable does not currently use webhooks with Ingram Micro, so you do not need it. Uncheck the box and move on.
- Enter your Ingram Micro sales/account manager's email if prompted — this speeds up approval
- Submit the app request
Now you wait. Approval typically takes 2-4 business days. If you want it faster, email or call your Ingram Micro sales rep and ask them to expedite.
Step 3: Get Your Credentials
Once Ingram approves your production app, three things will be waiting in your developer portal:
| Credential | What It Looks Like |
|---|---|
| Customer Number | XX-XXXXXX (your Ingram reseller ID, first 8 characters including the dash) |
| Client ID | A long alphanumeric string. Found under your app details in "My Apps". |
| Client Secret | Another long alphanumeric string. Same location as Client ID. |
To find them: Go to My Apps, click the name of your approved production app. The Client ID and Client Secret are displayed there.
Copy these carefully. One wrong character and the connection fails.
Step 4: Connect in Scopable
Almost done.
- Log into Scopable
- Go to Settings > Integrations > Ingram Micro
- Enter your Customer Number (XX-XXXXXX format, 8 characters including the dash)
- Paste your Client ID
- Paste your Client Secret
- Click Connect
Scopable will validate the credentials instantly. If everything checks out, you will see a green "Connected" status. Your Ingram product catalog, pricing, and availability data will start flowing into your quotes.
Your credentials are encrypted and stored securely. Scopable never exposes them in the UI after initial entry. We cannot see your Client Secret.
Troubleshooting
"Invalid API call as no apiproduct match found"
Your production app has not been approved yet, or you did not enable the right API products when you created the app. Check your developer portal under My Apps. If the app is still pending, contact your Ingram sales rep.
"Invalid customer number"
The customer number you entered in Scopable does not match the one registered with your API credentials. Double-check the format: XX-XXXXXX. Only the first 8 characters including the dash. Some Ingram accounts have longer numbers but the API only uses the first 8.
"Authentication failed"
Your Client ID or Client Secret is wrong. Go back to developer.ingrammicro.com, open your production app under My Apps, and copy the credentials again. Carefully. No trailing spaces.
Connection worked yesterday, broken today
Two likely causes. First: Ingram revoked your credentials for abusive API usage (unlikely if you are using Scopable normally). Second: your Ingram Micro reseller account fell out of good standing. Contact your Ingram rep.
Still stuck?
Email us at [email protected] with a screenshot of the error. We will figure it out together. Not a chatbot. A person.
FAQ
Does this cost anything?
No. Ingram Micro provides API access free of charge. No integration fees, no yearly maintenance. They expect the API to be used for legitimate business purposes, which it is.
Can I use my sandbox credentials?
No. Sandbox credentials only work with test data. Scopable connects to production. You need approved production credentials.
What data does Scopable pull from Ingram?
Product catalog (SKUs, descriptions, specs), real-time pricing and availability, quotes, orders, invoices, renewals, deals, returns, and freight estimates. Basically everything you would normally look up manually on Ingram's portal. Except faster.
Can multiple people at my company use this?
Yes. The Ingram integration is tied to your Scopable tenant, not individual users. Anyone on your Scopable team can use features that pull Ingram data. You only set up the credentials once.
What if I already registered for Ingram's old XML API?
Ingram decommissioned the XML API in April 2025. Everyone is on the REST API now. You will need to register on the new developer portal at developer.ingrammicro.com. Your old XML credentials will not work.
What happens to my credentials if I cancel Scopable?
Your credentials are deleted from our systems when your account is removed. The API keys themselves remain active on your Ingram developer account. You can use them with other tools or revoke them in Ingram's portal.