Stay organized with collectionsSave and categorize content based on your preferences.
This page
applies toApigeeandApigee hybrid.
This page describes how to set up custom curations in API hub. Custom curations enable you to override the default curation logic of yourplugin instancesto implement a tailored data transformation and enrichment process based on your organization's needs.
Before you begin
Ensure the following before setting up a custom curation:
In the navigation menu, clickIntegrations. TheIntegrationspage appears.
Clickadd_boxCreate integrationand provide the following details in theCreate Integrationpage:
Integration name:Enter a name for your integration.
Description:Optionally, enter a description for your integration.
Region:Select the region for your integration. This must be the same region as your API hub instance.
ClickCreateto open the integration in the integration editor.
Configureintegration variablesusing theApiDatadefinition. These variables will be used as input and output task variables for the custom curation logic.
Add anAPI triggerand use the availabletasksto build your custom curation logic.
Once complete, clickPublishto publish the integration.
For more information about Application Integration, see theApplication Integrationdocumentation.
Set up a custom curation
Once you have created and published your integration in Application Integration, you can
set up the custom curation in API hub. To set up a custom curation, do the following:
In the Google Cloud console, go to theAPI hubpage.
ClicksettingsSettingsfrom the left navigation menu to open theSettingspage.
Click theCurationstab to view the list of curations.
ClickSetup a new curation.
In theSet up curationpane, provide the following details:
Optional: ClickSpecify IDto provide a unique ID for the curation. API hub generates a unique ID if you don't provide one.
Display name: Enter a name for the curation.
Description: Enter a description for the curation.
If you have an existing integration created for your curation logic in Application Integration, do the following underAssociate an existing integrationsection:
Integration: Choose the integration that you want to associate for the curation.
Trigger ID: Choose the API trigger ID that you want to associate for the curation.
If you don't have an existing integration created for your curation logic in Application Integration, follow the instructions inCreate an integration for the custom curationto create an integration and then continue fromStep 5d.
ClickCreate curationto initiate the creation of the custom curation.
On successful creation, the curation is listed underManage curationsas 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-09-04 UTC."],[],[],null,["# Create curations\n\n*This page\napplies to **Apigee** and **Apigee hybrid**.*\n\n\nThis page describes how to set up custom curations in API hub. Custom curations enable you to override the default curation logic of your [plugin instances](/apigee/docs/apihub/plugins#plugin-instance) to implement a tailored data transformation and enrichment process based on your organization's needs.\n\nBefore you begin\n----------------\n\nEnsure the following before setting up a custom curation:\n\n- Provision Application Integration in your Google Cloud project. See [Set up Application Integration](/application-integration/docs/setup-application-integration) for more information. **Note:** You must provision Application Integration in the same Google Cloud project and region as your API hub instance.\n\nCreate a custom curation\n------------------------\n\nTo create a new custom curation logic, do the following:\n\n1. [Create an integration for the custom curation](#create-integration) in Application Integration.\n2. [Set up a custom curation](#create-custom-curation) in API hub.\n\n### Create an integration for the custom curation in Application Integration\n\n\nTo create a custom curation logic in Application Integration, perform the following steps:\n\n1. In the Google Cloud console, go to the **Application Integration** page.\n\n [Go to Application Integration](https://console.cloud.google.com/integrations)\n2. In the navigation menu, click **Integrations** . The **Integrations** page appears.\n3. Click add_box **Create integration** and provide the following details in the **Create Integration** page:\n 1. **Integration name:** Enter a name for your integration.\n 2. **Description:** Optionally, enter a description for your integration.\n 3. **Region:** Select the region for your integration. This must be the same region as your API hub instance.\n 4. Click **Create** to open the integration in the integration editor.\n4. Configure [integration variables](/application-integration/docs/variables#integration_var) using the [`ApiData`](/apigee/docs/reference/apis/apihub/rest/v1/projects.locations/collectApiData#ApiData) definition. These variables will be used as input and output task variables for the custom curation logic.\n5. Add an [API trigger](/application-integration/docs/configure-api-trigger) and use the available [tasks](/application-integration/docs/tasks) to build your custom curation logic.\n6. Once complete, click **Publish** to publish the integration.\n\n\nFor more information about Application Integration, see the [Application Integration](/application-integration/docs/overview) documentation.\n\n### Set up a custom curation\n\n\nOnce you have created and published your integration in Application Integration, you can\nset up the custom curation in API hub. To set up a custom curation, do the following:\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 **Curations** tab to view the list of curations.\n4. Click **Setup a new curation**.\n5. In the **Set up curation** pane, provide the following details:\n 1. Optional: Click **Specify ID** to provide a unique ID for the curation. API hub generates a unique ID if you don't provide one. **Note:** The ID must be between 4 to 500 characters in length and can only contain the following characters: `/[A-Z][a-z][0-9]-/.`\n 2. **Display name**: Enter a name for the curation.\n 3. **Description**: Enter a description for the curation.\n 4. If you have an existing integration created for your curation logic in Application Integration, do the following under **Associate an existing integration** section:\n 1. **Integration** : Choose the integration that you want to associate for the curation. **Note:** Only published integrations can be associated for curations.\n 2. **Trigger ID**: Choose the API trigger ID that you want to associate for the curation.\n 5. If you don't have an existing integration created for your curation logic in Application Integration, follow the instructions in [Create an integration for the custom curation](#create-integration) to create an integration and then continue from [Step 5d](#associate-integration).\n6. Click **Create curation** to initiate the creation of the custom curation.\n\n On successful creation, the curation is listed under **Manage curations** as shown in the following image:\n\n\nWhat's next\n-----------\n\n- Learn how to [view and manage curations](/apigee/docs/apihub/manage-curations).\n- Learn how to [edit the configuration of a plugin instance](/apigee/docs/apihub/manage-plugin-instances)."]]