Contact Us 1-800-596-4880

Upgrading and Migrating Anypoint MQ Connector to 4.x

Upgrade Anypoint Connector for Anypoint MQ (Anypoint MQ Connector) to version 4.x.

Supported Upgrade Paths

From Version To Version



Changes in This Release

The changes included in this version break backward compatibility.

Anypoint MQ Connector 4.x includes support for the Connected Apps feature.

This release contains a new format for the URL field in the Global Element Properties page.

  • In Anypoint MQ Connector 3.x, the URL format was:

  • In Anypoint MQ Connector 4.x, the URL format includes {orgID} and {envID}. For example:{orgID}/environments/{envID}

If you configure the connector with the wrong version of the URL, Anypoint MQ returns the following error:

Invalid api url provided

Upgrade Prerequisites

Before you perform the upgrade, you must create a backup of your files, data, and configurations in case you need to revert to the previous version.

Upgrade Steps

To upgrade to Anypoint MQ Connector 4.x:

  1. In Anypoint MQ, in the Destinations page, click Copy and select Connector version 4.x and later from the menu:

    Copy button in the Destinations page
  2. In Anypoint Studio, open the Mule project.

  3. In the Mule Palette view, click Search in Exchange.

  4. In Add Dependencies to Project, type Anypoint MQ in the search field.

  5. In Available modules, select Anypoint MQ Connector - Mule 4 and then click Add.

  6. Click Finish.

    Anypoint Studio upgrades the connector automatically.

  7. Verify that the mq-connector dependency version is 4.0.0 in the pom.xml file:

  8. In Anypoint Studio, in the Anypoint MQ Config window, paste the URL in the URL field:

    URL, Client App ID, and Client Secret fields in the Anypoint MQ Config window
  9. Depending on your authentication method, complete the Client App ID and Client Secret fields:

    • Connected App:

      Paste the values of ID and Secret from Anypoint Platform > Access Management > Connected Apps.

      For information about configuring Connected Apps in Anypoint MQ, see Configuring Connected Apps.

    • Client App:

      Paste the values of Client App ID and Client Secret from Anypoint Platform > MQ > Client Apps.

      For information about configuring Client Apps in Anypoint MQ, see Configuring Client Apps.

Post Upgrade Steps

After you install the latest version of the connector, follow these steps to complete the upgrade:

  1. In Anypoint Studio, verify that there are no errors in the Problems or Console views.

  2. Check the project pom.xml and verify that there are no problems.

  3. Test the connection and verify that the operations work.


If you experience problems with caching the parameters and caching the metadata, restart Anypoint Studio.

Reverting the Upgrade

If it is necessary to revert to the previous version of Anypoint MQ Connector, in Anypoint Studio, change the mq-connector dependency version 4.0.0 in the project’s pom.xml file to the previous version.

View on GitHub