Ensure there is an available VPC network in the Google Cloud project you will use to provision
Apigee. To view available VPC networks in your project, go to theVPC Networkspage:
If there is no available network in your project, you may encounter an error during provisioning.
For more details, seeTroubleshoot one-click provisioning.
Provision Apigee with one click
To start one-click provisioning for a new Apigee Pay-as-you-go organization:
Go to theWelcome to Apigee API managementpage in the Google Cloud console.
Default networking: This resource uses the default authorized network and subnetwork in your Google Cloud
project and automatically allocates IP ranges for network peering and runtime IPs.
A Google-managed domain: This includes thenip.iowildcard DNS service
and a Google-managed SSL certificate to secure your domain.
Creates the following permanent resource:
Google-managed encryption key: This resource includes encryption keys for runtime database
and runtime disk encryption.
API hubinstance: A newAPI hub instanceis created in the same project and region as your Apigee organization. If you need API hub with
customer-managed encryption keys, you must delete the auto-provisioned API hub instance and
create a new API hub instance in the same project and region as your Apigee organization.
TheProvisioning Apigeepage displays when provisioning begins. You can monitor
progress and view the approximate time remaining to complete from this page. Provisioning may take up toone hour.
Once the required APIs are enabled, as indicated bycheck_circleEnabled, you can leave the page. A notification will
appear in the Google Cloud console when the provisioning operation completes.
When provisioning completes, theApigee Dashboardpage displays. Congratulations! You can begin exploring Apigee!
Troubleshoot one-click provisioning
If the resources required to provision Apigee are not available in your Google Cloud project,
you may encounter an error message after clickingSet up with defaultson theWelcome to Apigee API managementpage, as shown below:
You may encounter this message if:
There is no available VPC network in the Google Cloud project you are using to provision
Apigee.
Your Google Cloud organization has a policy restricting the creation of resources in the region used
for Apigee provisioning. For more information, seeIntroduction to the Organization Policy Service.
If you encounter this error, we recommend clickingCustomize your setupto customize the
required resources created for Apigee in your project.
[[["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."],[[["\u003cp\u003eThis documentation pertains specifically to Apigee and does not apply to Apigee hybrid.\u003c/p\u003e\n"],["\u003cp\u003eA new Apigee Pay-as-you-go organization can be provisioned with a single click using smart default configurations.\u003c/p\u003e\n"],["\u003cp\u003eBefore provisioning, users must ensure they have completed the prerequisites and have an available VPC network within their Google Cloud project.\u003c/p\u003e\n"],["\u003cp\u003eOne-click provisioning enables required APIs, creates default networking and a Google-managed domain, and sets up a permanent Google-managed encryption key.\u003c/p\u003e\n"],["\u003cp\u003eIf resource availability issues are encountered during provisioning, users can opt to customize their setup to tailor the resources needed for Apigee.\u003c/p\u003e\n"]]],[],null,["# Provision Apigee with one click\n\n*This page\napplies to **Apigee** , but not to **Apigee hybrid**.*\n\n\n*View [Apigee Edge](https://docs.apigee.com/api-platform/get-started/what-apigee-edge) documentation.*\n\nYou can provision a new Apigee Pay-as-you-go organization with just one click, using smart\ndefault configuration settings.\n\nBefore you begin\n----------------\n\nBefore you provision your Apigee Pay-as-you-go organization:\n\n1. Review and complete the steps described in these topics:\n - [Prerequisites](/apigee/docs/api-platform/get-started/prerequisites)\n - [Get started in the Google Cloud console](/apigee/docs/api-platform/get-started/console-select-project)\n2. Ensure there is an available VPC network in the Google Cloud project you will use to provision Apigee. To view available VPC networks in your project, go to the **VPC Networks** page:\n\n [Go to VPC networks](https://cloud.google.com/console/networking/networks/list)\n\n If there is no available network in your project, you may encounter an error during provisioning.\n For more details, see [Troubleshoot one-click provisioning](#troubleshoot).\n\nProvision Apigee with one click\n-------------------------------\n\nTo start one-click provisioning for a new Apigee Pay-as-you-go organization:\n\n1. Go to the **Welcome to Apigee API management** page in the Google Cloud console.\n\n [Go to Apigee API Management](https://cloud.google.com/console/apigee/welcome)\n2. Click **Set up with defaults** .\n\n When you select this one-click option, Apigee does the following:\n - Enables the required APIs\n - [Apigee API](https://console.cloud.google.com/apis/library/apigee.googleapis.com)\n - [API Hub API](https://console.cloud.google.com/apis/library/apihub.googleapis.com)\n - [Compute Engine API](https://console.cloud.google.com/apis/library/compute.googleapis.com)\n - [Cloud Key Management Service (KMS) API](https://console.cloud.google.com/apis/library/cloudkms.googleapis.com)\n - [Service Networking API](https://console.cloud.google.com/apis/library/servicenetworking.googleapis.com)\n - Creates the following configurable resources:\n - **Default networking**: This resource uses the default authorized network and subnetwork in your Google Cloud project and automatically allocates IP ranges for network peering and runtime IPs.\n - **A Google-managed domain** : This includes the `nip.io` wildcard DNS service and a Google-managed SSL certificate to secure your domain.\n - Creates the following permanent resource:\n - **Google-managed encryption key** : This resource includes encryption keys for runtime database and runtime disk encryption. **Note:** If you create this permanent resource using **Set up with defaults** for one-click provisioning, you cannot go back and change the encryption key selections. Apigee does not support updating the encryption key selections after provisioning is complete. For example, if Google-owned and Google-managed encryption keys are created using this option, you cannot change to Customer-managed encryption later.\n - **API hub** instance: A new [API hub instance](/apigee/docs/apihub/what-is-api-hub) is created in the same project and region as your Apigee organization. If you need API hub with customer-managed encryption keys, you must delete the auto-provisioned API hub instance and create a new API hub instance in the same project and region as your Apigee organization.\n\n \u003cbr /\u003e\n\n3. The **Provisioning Apigee** page displays when provisioning begins. You can monitor progress and view the approximate time remaining to complete from this page. Provisioning may take up to **one hour** .\n\n Once the required APIs are enabled, as indicated by check_circle **Enabled**, you can leave the page. A notification will\n appear in the Google Cloud console when the provisioning operation completes.\n4. When provisioning completes, the **Apigee Dashboard** page displays. Congratulations! You can begin exploring Apigee!\n\nTroubleshoot one-click provisioning\n-----------------------------------\n\nIf the resources required to provision Apigee are not available in your Google Cloud project,\nyou may encounter an error message after clicking **Set up with defaults** on the **Welcome to Apigee API management** page, as shown below:\n\nYou may encounter this message if:\n\n- There is no available VPC network in the Google Cloud project you are using to provision Apigee.\n- Your Google Cloud organization has a policy restricting the creation of resources in the region used for Apigee provisioning. For more information, see [Introduction to the Organization Policy Service](/resource-manager/docs/organization-policy/overview).\n\nIf you encounter this error, we recommend clicking **Customize your setup** to customize the\nrequired resources created for Apigee in your project."]]
