Overview

This guide provides step-by-step instructions to integrate MachineQ Output Profiles with the ConnectedFresh API. Once configured, MachineQ will send real-time device data to your ConnectedFresh dashboard for monitoring and analytics.

Prerequisites

• Your MachineQ account must have Administrator or Manager permissions.
• ConnectedFresh must provide you with:
  • x-api-key (authorization token)
  • API endpoint URL

Part 1: Create an Application in MachineQ

Step 1: Access Application Management

1. Log in to your MachineQ Dashboard.
2. Navigate to Integrations → Application Management from the left-hand menu.
   
   

Step 2: Create a New Application

1. Click Add Application.
2. Enter an application name, e.g., ConnectedFresh_Integration.
3. Click Save.
   

Step 3: Retrieve Credentials

1. After saving, MachineQ will generate a Client ID and Client Secret.
2. Securely share these credentials with the ConnectedFresh team.
   

These credentials allow ConnectedFresh to securely authenticate incoming data from your MachineQ account.

Part 2: Configure Output Profile in MachineQ

Step 1: Open Output Profiles

1. In the MachineQ Dashboard, go to Integrations → Output Profiles.

Step 2: Create Output Profile

1. Click Add Output Profile.
2. Name it something descriptive, e.g., ConnectedFresh_Output_Prod.
3. Click Next.
4. Select the devices you wish to forward to ConnectedFresh.
5. Click Next again.
   
   

Step 3: Add Webhook Destination

1. Under Destination Type, select Webhook.
   
2. Enter the following configuration details:

Authorization Summary

• MachineQ generates the Client ID and Client Secret in Application Management.
• ConnectedFresh provides the x-api-key which must be entered in the Webhook configuration.
• This ensures secure and authenticated data transmission between MachineQ and ConnectedFresh.

✅ Integration Complete

Once configured, data from your MachineQ devices will begin streaming to your ConnectedFresh dashboard in real time.

Troubleshooting

• Verify that the x-api-key is entered correctly.
• Ensure the correct devices are added to the Output Profile.
• Check that Payload Delivery is enabled.
• If data is still not visible, contact support@connectedfresh.com with screenshots of your Output Profile settings.