Manage Partners and Profiles in Azure BizTalk Services



Microsoft Azure BizTalk Services (MABS) is being retired, and replaced with Azure Logic Apps. If you currently use MABS, then Move from BizTalk Services to Logic Appsprovides some guidance on moving your integration solutions to Logic Apps.

If you're brand new to Logic Apps, then we suggest getting started here:

The Partners page displays the list of partners with their name, email, phone, and description. Using this page, you can add or delete partners and their profiles.

It is important to understand the concept of a Service Provider and a Partner. The Service Provider is you or your company. A Partner is whomever you receive or send EDI files, which can include another company, another department within your company, and so on. Pipelines are deployed for the Hosted Partner when the agreement is deployed. Receive and Send settings are oriented to the context of the Hosted Partner. For example, the receive settings in an agreement determine how the Hosted Partner receives messages sent from a Guest Partner. Likewise, the send settings on the agreement indicate how the Hosted Partner sends messages to the Guest Partner.

In this topic:

Add a new partner

Add or Edit a profile for a partner

Add a certificate

Add a new partner

After you register yourself as the service provider, you can add or delete trading partners in the BizTalk Services Portal.

  1. In the BizTalk Services Portal home page, click Partners.

  2. In Partners, click Add.

  3. In New Partner, enter the following:

    Partner name

    Required. Enter the name of the partner. The name must be unique.


    Enter a note or description for the partner.

    First name

    Enter the first name of the primary contact in the partner organization.

    Last name

    Enter the last name of the primary contact in the partner organization.

    Email ID

    Enter the email ID of the primary contact in the partner organization.


    Enter the phone number of the primary contact in the partner organization.

    Website URL

    Enter the website of the partner organization.


    Enter the country/region of the partner organization.

    Address (Line1)

    Enter the address of the partner organization.

    Address (Line2)

    Enter any additional address information of the partner organization.


    Enter the city of the partner organization.


    Enter the state of the partner organization.

    Postal Code

    Enter the postal zip code of the partner organization.

  4. Click Save to add the partner.

When the partners are added, profiles are created automatically.


When you add you or your company as a Service Provider, you are not automatically added as a Partner. This feature allows you to add multiple partners as the Hosted Partner or Guest Partner, including creating agreements between multiple partners.

To Delete a Partner:

Select the row listing the partner that you want to delete and then select Delete.


You cannot delete a partner unless all the profiles and all the agreements for that partner are deleted.

Add or Edit a profile for a partner

Profiles are organization-specific settings that can correspond to organizational divisions. For example, a partner retail organization named Contoso has an “Electronics” division that accepts orders for electronics inventory. This Electronics division submits requests for electronics supplies to a partner. Contoso also has an “Apparel” division that accepts orders for clothing and then submits requests for clothing supplies to a partner. In this scenario, two profiles for the Contoso partner organization are created: “Contoso Electronics” and “Contoso Apparel”.

A default profile is always created when a partner is added. Profiles can be changed.

  1. On the BizTalk Services Portal home page, click Partners.

  2. Click on the partner name to open the Profiles page for the partner.


    To return to the BizTalk Services Portal home page, click the back button in the upper left corner.

  3. Click Add to create a new profile, or click the existing profile.

  4. In the new profile page, enter the follow information:

    Profile Name

    Required. Enter a unique name for the profile.


    Optional. Enter information that describes this particular profile, like “Contoso Electronics”.


    Add any identity qualifier values to be used with this profile by clicking +. Choose a qualifier code from the drop down list and enter the value.


    A certificate can be added after a profile is created and saved. Certificates in the profile can be used for digital signatures with AS2.

  5. Click Save.

When the Partner and Profile are complete, an Agreement can be created. See Create Agreements in Azure BizTalk Services.

To Delete a Profile:

Select the partner that has the profile you want to delete. Then select the row listing the profile, and then select Delete.

Add a certificate

Once a profile is saved, you can add a certificate to that profile. Certificates in a partner’s profile are used for message signing and encryption/decryption.

  1. In the BizTalk Services Portal home page, click Partners, click the Partner name, and then click the profile.

  2. In the Certificates section, click Add.

  3. Browse to the location of the certificate file. A trading partner’s public certificate (CertificateName.cer) or your own private certificate (CertificateName.pfx) can be used.

    Private certificates (.pfx) are password protected. If you are adding a private certificate (.pfx), enter the Password.

  4. Click Save.


To see the added certificates, select Resources on the BizTalk Services Portal home page, and then select Certificates. The BizTalk Services Portal also provides notifications for expired certificates.

For information on importing certificates on the computer, see APPENDIX: BizTalk Services Certificates Overview.


Create Agreements in Azure BizTalk Services

See Also

Configuring EDI, AS2, and EDIFACT on BizTalk Services Portal