---
schema_version: "1"
id: 3a709a59c240c053dbfdb223f5d4c5ff803f8e037e7b49744972c513df6b14ca
title: Create API Groups and Add API Instances
collection: mulesoft
version: current
locale: en-us
portal_url: https://docs.salesforce.com/mulesoft/current/en-us/api-manager/latest/api-groups-creating-groups.md
canonical_url: https://docs.mulesoft.com/api-manager/latest/api-groups-creating-groups
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 1c12acfa6638276f8b172975869dd2f80d9681735581305a58b9304504d73742
description: MuleSoft Documentation Site
release: 2.x
latest: true
---
---
product: API Manager
version: 2.x
is-latest-version: true
---

# Create API Groups and Add API Instances

> For the full documentation index, see: https://docs.mulesoft.com/llms.txt

To package a set of APIs, you first create an API Group and then add the relevant API instances to
the group. If you want your API Group to be discovered by consumers, you must publish it to
Exchange.

Using the following information, you create an API Group, including creating an API Group, creating
the very first version of that group, and creating the very first group instance. Additionally, you
add API instances to the API Group instance.

You can add API instances to the API Group instance based on the environment (production, sandbox,
or others) in which you create the API Group instance. For example, if you created an API Group
instance in a production environment, you can add API instances to the API Group instance only from
production.

You create API Groups using the following steps:

1.  [Create an API Group](#create-api-groups)

    The first step to creating an API Group that can be used by consumers is to create an API Group.

2.  [Add API instances to the new API Group](#adding-api-instances-to-groups)

    After you create the API Group, you then add API instances to this group for the first time.

## Task Prerequisites

Before you begin, you must have:

- At least one API instance in your organization or business group

  Otherwise, you will not be able to find the required organization or business group in the list.

- API Group Administrator permissions to create API Groups

## Create API Groups

You create an API Group at the organization level.

To create API Groups:

1.  Navigate to **Anypoint Platform** > **API Manager**.

2.  Click **API Groups** > **Create API Group**.

3.  In the **API Group name** field, specify a name for the API Group that you want to create: for
    example, `Social Chatter`.

4.  In the **API Group version** field, specify the version for the API Group: for example, `v1`.

5.  Optionally, in the **API Group instance label** field, specify a label for the API Group, such
    as `Internal` if you want to use it for internal purposes.

6.  Click **Continue**.

The **Creating a new group** page is displayed. You are now ready to
[add API instances](#adding-api-instances-to-groups) to the API Group.

## Add API Instances to API Groups

Your API Group is not functional until you add the API instances to the group that you want to
bundle. When you add API instances to an API Group, you can add:

- Only those API instances that belong in the same business group or organizations

- Only those API instances that belong to same environment type as the API Group instance

- Only those API instances that belong to the same identity provider (IdP)

  You cannot mix IdPs in an API Group instance.

To add a new API instance to a new API Group:

1.  On the **Creating a new group** page, select an environment from the **Select environment**
    drop-down list:

2.  From the **Select an API** list, select the API instance that you want to add.

3.  From the **Select a version / instance** list, select the version of the API instance that you
    want to add to the group.

4.  If you want to include additional API instances in the API Group, click **Add** and specify the
    details.

5.  If the API instance and the API Group belong in different business groups:

    1.  Click **Add Organization**.

    2.  Select the organization or business group in which your API instance is available and click
        **Add**.

    3.  Select the environment, API instance, and version that you want to add.

6.  Click **Save**.

    Your API instances are now added to the API Group.

## See Also

- [API Groups](https://docs.mulesoft.com/api-manager/latest/api-groups-landing-page)

- [Modify API Groups](https://docs.mulesoft.com/api-manager/latest/api-groups-modifying-groups)

- [Publish API Groups to Exchange](https://docs.mulesoft.com/api-manager/latest/api-groups-publishing-to-exchange)

- [Deprecate API Groups](https://docs.mulesoft.com/api-manager/latest/api-groups-deprecating-groups)

- [Delete API Groups](https://docs.mulesoft.com/api-manager/latest/api-groups-deleting-groups)