Stay organized with collections
Save and categorize content based on your preferences.
This page
applies to Apigee and Apigee hybrid.
This page describes how to create plugin instances in API hub. A plugin instance represents a configured and active connection between API hub and a specific API data source via the associated plugin. For more information about plugin instances, see Plugin instance.
How plugin instances are created
Plugin instances are created automatically or manually depending on the plugin type and the action that you perform.
For all Built-in Google Cloud plugins, API hub automatically creates a plugin instance during the process of attaching a runtime project to API hub. For more information, see Attach a runtime project.
For all other plugins, you can create a plugin instance manually from the Settings page in API hub. For more information, see Create a plugin instance.
Click settingsSettings from the left navigation menu to open the Settings page.
Click the Plugins tab to view the available plugins in your project.
Hold the pointer over the desired plugin, and then click Create instance.
Configure the following fields in the Create a plugin instance pane. The configuration options depend on the plugin type.
Display name: Enter a name for the plugin instance.
Curation: Select the curation settings for the plugin instance. By default, the curation level is set to Default.
Organization: Choose the Apigee Edge organization that hosts the plugin data. This field is only available for Apigee Edge public cloud and Apigee Edge private cloud (OPDK) plugins.
Source project ID: Enter the unique identifier of the source project from which the plugin will import the data. This field is only available for custom plugins.
Service account: Enter the associated service account of the source project. This field is only available for Apigee Edge private cloud (OPDK) plugins.
Click Create to initiate the creation of the plugin instance.
You can view the status of the plugin instance in the Plugins tab under Manage instances. On successful creation, the status of the plugin instance is displayed as Active as shown in the following image:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[],[],null,["# Create plugin instances\n\n*This page\napplies to **Apigee** and **Apigee hybrid**.*\n\n\nThis page describes how to create plugin instances in API hub. A plugin instance represents a configured and active connection between API hub and a specific API data source via the associated plugin. For more information about plugin instances, see [Plugin instance](/apigee/docs/apihub/plugins#plugin-instance).\n\nHow plugin instances are created\n--------------------------------\n\n\nPlugin instances are created automatically or manually depending on the [plugin type](/apigee/docs/apihub/plugins#plugin-types) and the action that you perform.\n\n- For all Built-in Google Cloud plugins, API hub automatically creates a plugin instance during the process of attaching a runtime project to API hub. For more information, see [Attach a runtime project](/apigee/docs/apihub/auto-register-apigee-proxies#attach-a-runtime-project).\n- For all other plugins, you can create a plugin instance manually from the **Settings** page in API hub. For more information, see [Create a plugin instance](#create-plugin-instance). **Note:** To create a custom plugin instance, you must first create the plugin using the REST API. For more information, see [Create custom plugins](/apigee/docs/apihub/create-custom-plugins).\n\n\u003cbr /\u003e\n\nBefore you begin\n----------------\n\n- Ensure that you have the following [IAM permissions](/iam/docs/understanding-roles):\n - `apihub.plugininstances.create`\n - `apihub.plugininstances.delete`\n - `apihub.plugininstances.get`\n - `apihub.plugininstances.list`\n\n\n For information on granting roles to principals, see [Granting, changing, and revoking access](/iam/docs/granting-changing-revoking-access).\n- For Apigee Edge Public Cloud plugins, read about [Apigee Edge API hub connector integration](https://docs.apigee.com/api-platform/get-started/apigee-edge-uapim).\n- For Apigee Edge Private Cloud (OPDK) plugins, read about [API hub connector integration](https://docs.apigee.com/private-cloud/v4.53.00/privatecloud-uapim-overview).\n\nCreate a plugin instance\n------------------------\n\n| **Note:** The following steps apply only to non-Google Cloud and custom plugins. For Google Cloud plugins, a plugin instance is created automatically during the process of attaching a runtime project to API hub. For more information, see [Attach a runtime project](/apigee/docs/apihub/auto-register-apigee-proxies#attach-a-runtime-project).\n\n\nTo create a plugin instance, perform the following steps:\n\n1. In the Google Cloud console, go to the **API hub** page.\n\n [Go to API hub](https://console.cloud.google.com/apigee/api-hub)\n2. Click settings **Settings** from the left navigation menu to open the **Settings** page.\n3. Click the **Plugins** tab to view the available plugins in your project.\n4. Hold the pointer over the desired plugin, and then click **Create instance**.\n5. Configure the following fields in the **Create a plugin instance** pane. The configuration options depend on the plugin type.\n 1. **Display name**: Enter a name for the plugin instance.\n 2. **Curation** : Select the curation settings for the plugin instance. By default, the curation level is set to **Default**.\n 3. **Organization**: Choose the Apigee Edge organization that hosts the plugin data. This field is only available for Apigee Edge public cloud and Apigee Edge private cloud (OPDK) plugins.\n 4. **Source project ID**: Enter the unique identifier of the source project from which the plugin will import the data. This field is only available for custom plugins.\n 5. **Service account** : Enter the associated service account of the source project. This field is only available for Apigee Edge private cloud (OPDK) plugins. **Important:** For Apigee Edge private cloud (OPDK) plugin instances.\n |\n |\n | If your OPDK organization is within a project protected by a VPC Service Controls perimeter, then ensure that the service account is added to the VPC SC ingress policy. If the service account is not allowlisted, the plugin will fail to sync proxy data to API hub. For information about configuring VPC Service Controls, see [Configuring ingress and egress policies](/vpc-service-controls/docs/configuring-ingress-egress-policies).\n6. Click **Create** to initiate the creation of the plugin instance.\n\n You can view the status of the plugin instance in the **Plugins** tab under **Manage instances** . On successful creation, the status of the plugin instance is displayed as **Active** as shown in the following image:\n\n\nWhat's next\n-----------\n\n- Learn more about [managing plugin instances](/apigee/docs/apihub/manage-plugin-instances).\n- Learn more about [plugins](/apigee/docs/apihub/plugins).\n- Learn more about [curations](/apigee/docs/apihub/curations)."]]
