This tutorial shows you how to use Application Integration and connectors to create a sample integration that
triggers the publication of a Cloud Pub/Sub message. The tutorial assumes that you have a working
knowledge of Application Integration.
In this example, calling an API endpoint triggers the publication of a message to a Cloud Pub/Sub topic.
The steps below describe how to configure the API trigger and Pub/Sub connection required to run a successful integration.
Before you begin
Before beginning this tutorial, confirm your Google Cloud login credentials and organization details. This
information is required to access connectors UI. Your Apigee credentials are required to access the connectors task
within the Application Integration designer. Additional prerequisite steps are described below:
Before creating a connection for the first time, complete the following steps:
Create a new Apigee instance. New Apigee instances can
be provisioned with the Provisioning UI.
If you don't have a service account, create a service account.
A service account is a special type of Google account intended to represent a non-human
user that needs to authenticate and be authorized to access data in Google APIs.
If you don't have a service account, you must create a service account. For more
information, see
Creating a service account.
Enable required services
Connectors requires that you enable the following Google services:
Name
Title
apigee.googleapis.com
Apigee API
secretmanager.googleapis.com
Secret Manager API
connectors.googleapis.com
Connectors API
If these services have not been enabled for your project previously, you are prompted to enable them
when creating the connection in the Create Connection page.
[[["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-03 UTC."],[[["\u003cp\u003eThis tutorial demonstrates how to use Application Integration and connectors to create an integration that publishes messages to a Cloud Pub/Sub topic when an API endpoint is called.\u003c/p\u003e\n"],["\u003cp\u003eBefore using Application Integration and connectors for the first time with Apigee, you must create an Apigee instance, confirm your subscription includes these features, and then enable the features via a specific command.\u003c/p\u003e\n"],["\u003cp\u003eEnabling the Connectors feature requires activating the Apigee API, Secret Manager API, and Connectors API Google services, which can be done during connection creation or manually through the enabling services process.\u003c/p\u003e\n"],["\u003cp\u003eThis guide uses the Apigee platform, including Apigee hybrid, and requires users to have Google Cloud and Apigee login credentials, along with a service account.\u003c/p\u003e\n"]]],[],null,["# Get started with connectors\n\n*This page\napplies to **Apigee** and **Apigee hybrid**.*\n\n\n*View [Apigee Edge](https://docs.apigee.com/api-platform/get-started/what-apigee-edge) documentation.*\n\nThis tutorial shows you how to use Application Integration and connectors to create a sample integration that\ntriggers the publication of a Cloud Pub/Sub message. The tutorial assumes that you have a working\nknowledge of [Application Integration](/apigee/docs/api-platform/integration/what-is-apigee-integration).\n\nIn this example, calling an API endpoint triggers the publication of a message to a Cloud Pub/Sub topic.\nThe steps below describe how to configure the API trigger and Pub/Sub connection required to run a successful integration.\n\nBefore you begin\n----------------\n\nBefore beginning this tutorial, confirm your Google Cloud login credentials and organization details. This\ninformation is required to access connectors UI. Your Apigee credentials are required to access the connectors task\nwithin the Application Integration designer. Additional prerequisite steps are described below:\n\n- Before creating a connection *for the first time*, complete the following steps:\n\n | **Note**: These steps are only required if you are enabling the Application Integration and Connectors add-ons for the first time for use with Apigee.\n 1. Create a new Apigee instance. New Apigee instances can be provisioned with the [Provisioning UI](https://apigee.google.com/setup?project=).\n\n For the list of regions supporting connectors,\n see [Supported connector regions](/apigee/docs/api-platform/connectors/manage-connections#supported-regions).\n 2. Confirm that the Application Integration and connectors features are entitled to your Apigee subscription.\n 3. Enable the Application Integration and connectors features using the following command: \n\n ```carbon\n curl -H \"Authorization: Bearer $(gcloud auth print-access-token)\" -H \\\n \"content-type:application/json\" \\\n \"https://apigee.googleapis.com/v1/organizations/\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e:setAddons\" -XPOST \\\n -d '{\"addonsConfig\": {\"integrationConfig\": {\"enabled\": true}, \"connectorsPlatformConfig\": {\"enabled\": true}}}'\n ```\n | **Warning**: When you run an add-on command, it overwrites any existing add-ons. Therefore, if you have any existing add-ons, include them in the add-on command. Otherwise, the command to enable Application Integration and connectors will disable all other add-ons in your existing organization. And if an add-on is disabled, Apigee deletes all configurations of the add-on (feature). For example, if you disable the Integrations add-on, all integrations are deleted.\n 4. If you don't have a service account, create a service account. A service account is a special type of Google account intended to represent a non-human\n user that needs to authenticate and be authorized to access data in Google APIs.\n If you don't have a service account, you must create a service account. For more\n information, see\n [Creating a service account](/iam/docs/creating-managing-service-accounts#creating).\n\nEnable required services\n------------------------\n\n- Connectors requires that you enable the following Google services:\n\n- If these services have not been enabled for your project previously, you are prompted to enable them when creating the connection in the Create Connection page.\n- To understand how to enable services, see [Enabling services](/service-usage/docs/enable-disable#enabling).\n\nWhat's next\n-----------\n\n - Learn how to [create and use a Pub/Sub connection in your integration](/apigee/docs/api-platform/integration/get-started-connectors).\n - See the list of [supported connectors](/integration-connectors/docs/all-integration-connectors).\n - Learn how to [create and manage connections](/integration-connectors/docs/manage-connectors)."]]
