Stay organized with collections
Save and categorize content based on your preferences.
This page
applies to Apigee and Apigee hybrid.
API hub supports Eventarc triggers. By
using this feature, you can trigger executions based on the events occurring in API hub. For
example, you can execute a Cloud Run service when
an API is created in API hub.
This quickstart shows you how to create and configure an Eventarc trigger that executes a Cloud Run
service when an API is updated in API hub.
Before you begin
API hub must be provisioned in a Google Cloud project to which you have access.
See Provision API hub.
In the Google Cloud console, on the project selector page, select the project in which API
hub is provisioned.
You must have a valid Cloud Run service running. You will use the Cloud Run service details
when configuring the Eventarc trigger. This is the service that will be executed when
the configured event occurs.
Create an Eventarc trigger
In the Google Cloud console, go to the Eventarc Triggers page.
Enter a Trigger name.
For example, cloudrun-trigger-1.
In the Trigger type list, select Google sources.
This filters events sent from Google Cloud providers (directly or
through Cloud Audit Logs entries), or providers using Pub/Sub
messages.
In the Event provider list, select API hub.
In the Event type list, select google.cloud.apihub.v1.updated.
In the Event content data type list, select either JSON or Protobuf.
Select a Region.
Optionally, Add filters to select the APIs that match your criteria. For example, if you
filter the APIs by a specific name, the event is triggered only if the APIs matching the filter
criteria are updated.
If prompted, grant the following:
iam.serviceAccountTokenCreator role to Pub/Sub service account
pubsub.publisher role to Cloud Storage service account
Use the Default compute service account as the service account that
invokes your service.
In the Event destination list, select Cloud Run.
Select a Cloud Run service that should be executed when the
google.cloud.apihub.v1.updated event occurs in API hub.
[[["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-29 UTC."],[[["\u003cp\u003eThis guide details how to use Eventarc triggers with API hub to automate actions, such as executing a Cloud Run service when an API is updated.\u003c/p\u003e\n"],["\u003cp\u003eBefore creating an Eventarc trigger, you must provision API hub in a Google Cloud project and have a running Cloud Run service.\u003c/p\u003e\n"],["\u003cp\u003eTo create an Eventarc trigger, navigate to the Eventarc Triggers page in the Google Cloud console, and select API hub as the event provider and an API update event as the trigger.\u003c/p\u003e\n"],["\u003cp\u003eYou can optionally filter the APIs that trigger the event, like using the name of the APIs, and configure the specific Cloud Run service to execute when an API update occurs.\u003c/p\u003e\n"],["\u003cp\u003eThe guide is applicable to Apigee and Apigee hybrid users.\u003c/p\u003e\n"]]],[],null,["# Create an Eventarc trigger\n\n*This page\napplies to **Apigee** and **Apigee hybrid**.*\n\nAPI hub supports [Eventarc triggers](/eventarc/docs/overview#eventarc-triggers). By\nusing this feature, you can trigger executions based on the events occurring in API hub. For\nexample, you can execute a [Cloud Run](/run/docs/overview/what-is-cloud-run) service when\nan API is created in API hub.\n\nThis quickstart shows you how to create and configure an Eventarc trigger that executes a Cloud Run\nservice when an API is updated in API hub.\n\nBefore you begin\n----------------\n\n1. API hub must be provisioned in a Google Cloud project to which you have access. See [Provision API hub](/apigee/docs/apihub/provision).\n2. In the Google Cloud console, on the project selector page, select the project in which API\n hub is provisioned.\n\n [Go to project selector](https://console.cloud.google.com/projectselector2/home/dashboard)\n3. You must have a valid Cloud Run service running. You will use the Cloud Run service details when configuring the Eventarc trigger. This is the service that will be executed when the configured event occurs.\n\nCreate an Eventarc trigger\n--------------------------\n\n1. In the Google Cloud console, go to the Eventarc **Triggers** page.\n\n [Go to Triggers](https://console.cloud.google.com/eventarc/triggers)\n2. Click add_box **Create trigger**.\n3. Enter a **Trigger name** . For example, `cloudrun-trigger-1`.\n4. In the **Trigger type** list, select **Google sources** .\n\n This filters events sent from Google Cloud providers (directly or\n through Cloud Audit Logs entries), or providers using Pub/Sub\n messages.\n5. In the **Event provider** list, select **API hub**.\n6. In the **Event type** list, select **google.cloud.apihub.v1.updated**.\n7. In the **Event content data type** list, select either `JSON` or `Protobuf`.\n8. Select a **Region**.\n9. Optionally, **Add filters** to select the APIs that match your criteria. For example, if you filter the APIs by a specific name, the event is triggered only if the APIs matching the filter criteria are updated.\n10. If prompted, grant the following:\n - `iam.serviceAccountTokenCreator` role to Pub/Sub service account\n - `pubsub.publisher` role to Cloud Storage service account\n11. Use the **Default compute service account** as the service account that invokes your service.\n12. In the **Event destination** list, select **Cloud Run**.\n13. Select a Cloud Run service that should be executed when the `google.cloud.apihub.v1.updated` event occurs in API hub.\n14. Optionally, enter the **Service URL path**.\n15. Click **Create**."]]
