Ingram Micro integration setup

If you’re new to integrations in Rewst, read through our introductory integration documentation here.

What does the Ingram Micro integration do?

Our Ingram Micro integration offers users a seamless and efficient way to access and manage cloud services and subscriptions. Users can streamline the procurement and provisioning processes, track usage and billing, and efficiently manage their cloud subscriptions, all from a single integrated platform.

Why use the Ingram Micro integration?

• Add and remove licenses for users

• License monitoring and management

Set up the Ingram Micro integration

Set up steps in Ingram Micro

Contact Ingram Micro Integration Support at [e-mail] if you don’t have access to your marketplace API credentials.

1. Create a new Staff Account for the Rewst Application.

2. Name this user rewst and ensure that you generate a safe, unique password.

3. Activate the API from the Ingram Cloud Marketplace. You can only have a single user assigned to the Marketplace API App that you create.

   • The user must be activated in the portal on the main Users page.

   • When you click the user, it may have an orange bar that says the user needs to accept the invite in their mail.

   • As an admin, you can activate the account manually for them and then reset the password if required.

Set up steps in Rewst

1. Navigate to Configuration > Integrations in the left side menu of your Rewst platform.

2. In the Integrations page, search for the Ingram Micro Cloud Marketplace integration.

3. Click on the integration tile to begin setup.
4. Fill out the configuration form as follows:

   1. Username: This is the username of the user associated with the API. Clicking on the Marketplace API menu on the left navigation will show you the username.

   2. Password: The password is the password of that account. This can be set in the "Users" section of the control panel. The right user will match the "Username" under "User Settings".

   3. Subscription Key: The subscription key can then be found on the Marketplace API.

5. Click Save Configuration.

6. Make sure you map your customers once the integration saves successfully. You may need to click Refresh Options for customers to populate.

Test the integration

1. Navigate to Automation > Workflows in Rewst.

2. Create a new workflow and name it with something short and descriptive, such as Test Ingram Integration.

3. Add the action List Customers to the workflow builder canvas, by dragging it from the left pane.

   
4. If the workflow succeeds and you see customers listed in the results, then you’re all set. If it fails, review the setup instructions and make sure customers are mapped in the integration in Rewst.

Actions and endpoints

For more on how actions work in Rewst, check out our introductory actions documentation here.

You can access Ingram Micro’s own API documentation here.

Action Name	Description	Endpoint Related to Action
Create Customer	Create a customer in the platform and associate it with the reseller that sends this request.	/customers
Create Order	Place an order for a set of products for a specific customer.	/resellers
Create Reseller		/resellers
Create Reseller Customer	Create a customer in the platform and associate it with the specified reseller.	/resellers
Estimate an Order Price	Get estimated prices of an order.	/resellers
Get Customer	Get extended details about a specific customer in the platform.	/customers
Get Order	Get extended details of a specific order.	/resellers
Get Report	Get extended details about a specific report in the platform.	/reports
Get Reseller	Get extended details about a specific reseller in the platform.	/resellers
Get Reseller’s Customers	Get a list of customers and their basic details for the specified reseller.	/reseller
Get Service Plan	Get extended details about a specific service plan with all possible switches in the platform.	/plans
Get Subscription	Get extended details of a specific subscription from the platform.	/subscriptions
Ingram Micro API Request	Generic action for making authenticated requests against the IM Cloud API
List Customers	Get a list of customers and their basic details.	/customers
List Orders	Get basic details of orders in the platform.	/resellers
List Products	Get a list of products available for the requester to sell or resell with details included.	/products
List Reports	Get a list of the reseller's rated data reports exported during the specified period.	/reports
List Reseller Customers	Get a list of customers and their basic details for the specified reseller.	/customers
List Reseller’s Orders	Get basic details of orders in the platform for the specified reseller.	/resellers
List Resellers	Get a list of resellers and their basic details.	/resellers
List Service Plans	Get basic details of service plans in the platform.	/plans
List Subscriptions	Get a list of subscriptions belonging to the customers of the reseller that sends the request.	/subscriptions
Schedule a One Time Report	Schedule generation of a one-time report.	/reports
Update Customer	Update details and status of the existing customer.	/customers
Update Order	Update existing order properties and status.	/resellers
Update Reseller	Update details of the existing reseller.	/resellers
Update Some of the Description Details	Update some of the subscription details.	/subscriptions
Update Subscription	Update some of the subscription details.	/subscriptions
Update Subscription Pricing Details		/subscriptions
Validate Product Activation Parameters	Validate activation parameters for a set of products.	/products