Publish BizTalk WCF-BasicHTTP endpoints in API Management

Expose your BizTalk WCF-BasicHTTP receive locations as endpoints within Azure API Management using the BizTalk Administration Console. You can also expose your SOAP endpoints through API Management from BizTalk using API Management in the Azure portal.


What is API Management? is a great resource to understand and learn more about this Azure service.


Create using API Management in Azure portal

  1. In the Azure portal, open up your API management, and select APIs:

    select API for BizTalk

  2. Select WSDL:

    select wsdl biztalk api

  3. Configure your WSDL properties:

    1. WSDL specification : Enter the full URI to your BizTalk SOAP endpoint. For example, enter something like or

    2. SOAP pass-through or SOAP to REST : Select your preference:

      • SOAP to REST: Create REST-based HTTP APIs from an existing SOAP-based web service
      • SOAP pass-through: Acts as a proxy for the SOAP API
    3. Enter your preferred Display Name, Name, Description, API Url suffix, Products, and Version.

      When finished, your WSDL configuration looks something like the following:

      create API from WSDL BizTalk

  4. Select Create.

Create using the BizTalk Administration


This feature is supported with WCF-BasicHTTP receive locations.

  1. In the BizTalk Administration Console, right-click your WCF-BasicHTTP receive location, and select Publish to API Management:

    publish menu option

  2. Configure your API management properties:

    1. Sign-in to your Azure subscription, select the Subscription and Resource Group that has your API management service, and then select your service.

    2. The WSDL specification link is automatically populated with your WSDL file. Replace localhost with the DNS name or IP address of the BizTalk Server.

    3. Select SOAP pass-through or SOAP to REST:

      • SOAP to REST: Create REST-based HTTP APIs from an existing SOAP-based web services

      • SOAP pass-through: Acts as a proxy for the SOAP API

        The API can be published both ways by changing the API URL suffix, and then publishing again using a different API type.

    4. The API name is automatically populated with the receive location name.

    5. Select an API URL suffix that is to be used by consumers of the API.

      When finished, your properties look similar to the following:
      publish to API window

  3. Select Publish. When successful, the receive location is displayed as a service in API Management in the Azure portal.

Do more

Azure API Management is a powerful service that is used by a lot of Azure services, including Logic Apps. API Management includes many features, including rate limits and quotas, who has access to your APIs, caching, and more. See What is API Management? to get started.