---
schema_version: "1"
id: 01ec45e6872febedd7e6863a8a5cf86fc195a2e8f7e16e49872a8a44a2006923
title: Sync MuleSoft Services into API Catalog
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/platform/264-0-0/api_catalog_sync_apis.md
canonical_url: https://help.salesforce.com/s/articleView?id=platform.api_catalog_sync_apis.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: a30c31c4ba79c5dc4840160062190db1e67aba0defa5788dcc75e21274444b30
description: Sync eligible new and updated versions of MuleSoft APIs and MCP servers into your catalog.
products:
  - Salesforce Platform
  - Security
release: "264"
---
# Sync MuleSoft Services into API Catalog

Sync eligible new and updated versions of MuleSoft APIs and MCP servers into your catalog.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Developer</strong>, <strong>Enterprise</strong>, <strong>Performance</strong>, and <strong>Unlimited</strong> Editions</td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d57663e70">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d57663e70 ">To access API Catalog:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d57663e70 ">
              <p>Available to Salesforce admins by default.</p>
              <p style="margin-bottom:0;">For other users, View Setup</p>
            </td>

          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d57663e70 ">To sync MuleSoft services:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d57663e70 ">Customize Application</td>

          </tr>
        </tbody>
      </table>

MuleSoft APIs that meet these criteria are eligible to sync into API Catalog.

- Are a REST API type
- Have an `sf-api-catalog` tag in Anypoint Exchange
- Have an additional `sf-api-topic` tag in Anypoint Exchange for APIs with agent or subagent annotations
- Have a consumer endpoint for at least one instance, where the consumer endpoint is a valid HTTPS URL
    
    Consumer URLs appear as destination URLs in API Catalog.
    
    For information about configuring APIs to meet these criteria, see [MuleSoft Documentation: Add and Remove Asset Tags](https://docs.mulesoft.com/exchange/to-describe-an-asset#add-and-remove-asset-tags) and [_MuleSoft Documentation_: Add API Instances](https://docs.mulesoft.com/api-manager/latest/add-api-instances).

For information about the criteria for syncing MCP servers into API Catalog, see [Manage MuleSoft MCP Servers in API Catalog](https://help.salesforce.com/s/articleView?id=platform.api_catalog_manage_mulesoft_mcp_servers.htm&release=264.0.0&type=5 "Discover MuleSoft MCP servers to use in Agentforce. Sync eligible new and updated versions of MCP servers from Anypoint Platform into your catalog. Then, create connections for them and add tools you allow the servers to use.").

API Catalog makes it easy to create secure connections for your MuleSoft APIs. Monitor API versions as they sync into the catalog, request API access, and select SLA tiers directly from the catalog.

![A flowchart shows steps in a process: connect orgs, sync, view and search, create connections, assign user permissions, activate actions, use actions.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-platform-extend_click-264-0-0-production-enus/5f7d9219-b7b1-4552-8891-f1aba9b289fc/extend_click/images/api_catalog_get_started_mulesoft_apis.png)

1. Ask an Anypoint Platform admin to complete the prerequisite configuration in the Anypoint Platform organization you want to sync APIs from. For details, see [_MuleSoft Documentation_: Connecting a Trusted Salesforce Organization to Anypoint Platform](https://docs.mulesoft.com/access-management/connecting-salesforce-orgs).
2. From Setup, in the Quick Find box, enter API Catalog, and then select **API Catalog**.
3. Click **Enable Sync**.
    
    The sync typically takes several minutes to complete, especially for the initial sync, and runs as a background operation.
4. Make sure the latest synced APIs show in their respective list by refreshing the page.
    
    If you don’t see the APIs that you expect, double check the prerequisites to sync into the catalog.

If you reach system limits during the sync, remove APIs or API versions that you no longer need. See [Remove APIs from API Catalog](https://help.salesforce.com/s/articleView?id=platform.api_catalog_remove_apis.htm&release=264.0.0&type=5 "You can remove entire APIs from API Catalog for all supported sources. You can also remove specific MuleSoft API versions. Keep your catalog current to use the latest APIs, including their associated actions.").

## Sync API Updates into the Catalog

When you update a synced API specification in Anypoint Platform, API Catalog picks up the updates on the next sync. Whether the sync applies the updates to the schema in Salesforce depends on the type of update and whether any affected components are in use.

The sync automatically applies supported updates to the schema. These are updates to operations that aren't in use and additive updates, such as adding operations, objects, properties, or parameters. However, the sync can’t apply unsupported updates, which are breaking updates to components that are in use. The sync can’t apply updates that remove, rename, or update required properties or parameters that active flows, Apex classes, or agent actions reference. Salesforce doesn't overwrite a schema that active actions depend on.

1. After the sync completes, check whether the schema updated as expected.
    
    If the expected update doesn't appear, the update might be an unsupported update. When the sync detects an unsupported update, no error appears in the UI. The sync completes normally but leaves the existing schema unchanged.
    
    For the full list of supported and unsupported schema updates, see [Schema Update Support](https://help.salesforce.com/s/articleView?id=platform.external_services_appendix_update_schema.htm&language=en_US) and [Manage External Services](https://help.salesforce.com/s/articleView?id=platform.external_services_view_edit.htm&language=en_US).
2. To apply a breaking schema update, use one of these approaches.
    - Remove the references, then re-sync.
        
        Update or remove the flows, Apex classes, or agent actions that reference the affected component. Then stop and restart the sync. After the sync, check your integrations for errors caused by the update.
    - Publish the update as a new API version.
        
        Publish the updated specification in Anypoint Platform as a new asset version. Salesforce treats it as a separate registration with no active operations, so it syncs without affecting integrations that reference the previous version. Publishing a new version is the recommended approach when active flows or Apex classes depend on the affected fields.

## Stop and Restart the API Sync

Stop and restart the sync if necessary. Stop and restart to sync APIs or MCP servers that you just added to Anypoint Platform to avoid waiting for the next scheduled sync. Also consider stopping the sync before creating API Catalog change sets for promotion to other orgs and restarting the sync after you're done.

1. From Setup, in the Quick Find box, enter API Catalog, and then select **API Catalog**.
2. To start the sync the first time or after you stop it, click **Enable Sync** on the API Catalog home page.
3. To stop and restart the sync at any time, click **Manage Sync** and enable or disable the sync by using the toggle.

#### See Also

- [_MuleSoft Documentation_: Connecting a Trusted Salesforce Organization to Anypoint Platform](https://docs.mulesoft.com/access-management/connecting-salesforce-orgs)
- [_MuleSoft Documentation_: Manage API Instances](https://docs.mulesoft.com/api-manager/latest/api-instance-landing-page)
- [System Limits](https://help.salesforce.com/s/articleView?id=platform.external_services_schema_def_limits.htm&language=en_US)
- [Schema Definitions](https://help.salesforce.com/s/articleView?id=platform.external_services_schema_def_definition.htm&language=en_US)
- [Schema Update Support](https://help.salesforce.com/s/articleView?id=platform.external_services_appendix_update_schema.htm&language=en_US)
- [Manage External Services](https://help.salesforce.com/s/articleView?id=platform.external_services_view_edit.htm&language=en_US)
- [Manage MuleSoft MCP Servers in API Catalog](https://help.salesforce.com/s/articleView?id=platform.api_catalog_manage_mulesoft_mcp_servers.htm&language=en_US)