Deploy to Apigee from the Postman API Builder

Apigee X enables developers to manage access to their APIs by abstracting services behind a secure proxy layer. Once connected to Apigee, you can view your API deployment status and history from within Postman.

Postman supports connecting to organizations and proxies hosted in Apigee X. Postman doesn't support connecting to Apigee hybrid.

Creating a service account and private key

When setting up the connection to Apigee, you need to enter a service account email and a private key. You can create the required items in your Google Cloud project. Follow the steps below to add a custom role, create a service account, and generate a private key.

To create a custom role, do the following:

Log on to the Google Cloud Platform console and go to your project settings.
Select Roles in the left navigation pane, and then click + Create Role.
Enter the required details for the role, and then click + Add permissions.
Select the checkbox next to the following permission properties (enter a property name to locate it in the list):
- apigee.deployments.list
- apigee.environments.list
- apigee.environments.get
- apigee.organizations.list
- apigee.organizations.get
- apigee.proxies.list
- apigee.proxies.get
- apigee.proxyrevisions.get
Click Add and verify that you added the correct permissions to the role.
Click Create to finish creating the custom role.

To create a service account, do the following:

Select Service Accounts in the left navigation pane.
Click + Create Service Account.
Enter the required details for the service account and click Create and Continue.
In the Role drop-down list, select the custom role you created (enter the custom role name to locate it in the list).

Postman recommends adding a custom role to the service account. If you can't add a custom role, you can instead add the Apigee API Reader role and the Apigee Environment Admin role to the service account.
Click Done to finish creating the service account.

To generate a private key, do the following:

Click the new service account to open it and click the Keys tab.
Click Add key, then select Create new key.
Click the JSON key type and click Create.

Your browser will automatically download a JSON file that has values for client_email and a private_key. You will use these values when connecting Postman to Apigee.

Connecting to Apigee

To connect to Apigee in Postman, click APIs in the sidebar and select an API. Click Deployments, and then select Apigee X.

To authenticate with Apigee, do the following:

Enter the Service Account Email and Private Key. You can find the values in the JSON file you downloaded.

Instead of manually entering the keys, you can upload the JSON file that has your service account email and private key. The values will be automatically populated.
click Connect.

To set up the connection to Apigee X, do the following:

Select the Organization that has the proxy you want to connect to Postman.
Enter a Nickname for this integration.
Select the API Proxy that you want to connect to your API in Postman.
Select one or more Environments where you deploy your API in Apigee X.
Click Complete Setup.

Viewing Apigee X deployments

After connecting to Apigee X, you can view the deployment status and history for your API definitions in Postman. Click APIs in the sidebar and select an API. Click Deployments.

For your API proxy, you can view the latest revision, source, creation date, and date last updated.
For each proxy endpoint, you can view the name and base paths.
For each Apigee environment, you can view the description, date last updated, status, deployed revision, and deployment date.

From the Deployments view, you can take the following actions:

To view your API proxy in Apigee X, select the Latest Revision or a Deployed Revision.
To view performance metrics for your API proxy in Apigee X, click API Metrics.
To see the latest deployment status, click Refresh.
To edit or delete the connection to Apigee X, click View more actions.