You're viewing **Apigee Edge** documentation.  
[Go to the
**Apigee X** documentation](http://cloud.google.com/apigee/docs). info

This section explains how to create a simple API proxy.

### Edge

To create an API proxy using the Edge UI:

1. Sign in to [apigee.com/edge](https://apigee.com/edge).
2. Click **API Proxies** in the main window:

   ![](https://docs.apigee.com/static/api-platform/images/tutorial_new_edge_apis_menu.png)
3. Click **+Proxy** .

   ![Create Proxy](https://docs.apigee.com/static/api-platform/images/tutorial_new_api_proxy_button.png)

   Apigee walks you through the process of creating a new proxy. First, select the type of proxy:

   ![](https://docs.apigee.com/static/api-platform/images/tutorial-proxy-type-v2.png)
4. Click **Reverse proxy (most common)**.

   Apigee displays the **Proxy details** page.
5. Configure your proxy details, as follows:
   - **Name:** Enter **getstarted**. If a proxy already exists with this name, then use a different name.
   - **Base path:** Ensure this is set to **/getstarted**.

     The base path is part of the URL used to make requests to your API. Edge uses the
     URL to match and route incoming requests to the proper API proxy.
   - **Description** (Optional): Enter a description for your new API proxy, such as **Get started proxy**.
   - **Target (Existing API):** Enter **https://mocktarget.apigee.net**. This defines the
     target URL that Apigee Edge invokes on a request to the API proxy.

     The mocktarget service is hosted at Apigee and returns simple data. It requires no API
     key or access token.

   Your proxy's details should look like the following:

   ![](https://docs.apigee.com/static/api-platform/images/getstarted-proxy-details-v2.png)
6. Click **Next**.
7. On the **Common policies** page, under Security: Authorization ensure that **Pass through (no authorization)** is selected, and click **Next** .

   ![](https://docs.apigee.com/static/api-platform/images/getstarted-passthrough-v2.png)
8. On the **Virtual hosts** page, select **default** and **secure** , and click **Next** .  
   ![](https://docs.apigee.com/static/api-platform/images/virtual-host-tutorial-v2-noflows.png)
9. On the **Summary** page, make sure the **Test** environment is selected under **Optional Deployment** and click **Create and
   deploy** :

   ![](https://docs.apigee.com/static/api-platform/images/getstarted-build-options-v2.png)

   Apigee creates your new API proxy and deploys it to your test environment:

   ![](https://docs.apigee.com/static/api-platform/images/getstarted-proxy-done-v2.png)
10. Click **Edit proxy** to display the Overview page for the API proxy:

    ![](https://docs.apigee.com/static/api-platform/images/getstarted-proxy-overview.png)

    Note that if you expand the **\[ + \]**, the UI lists both HTTP and HTTPS URLs
    for the test environment:

    ![](https://docs.apigee.com/static/api-platform/images/getstarted-proxy-urls.png)

    As a result, you can send requests to either, but this tutorial uses HTTPS.

### Classic Edge (Private Cloud)

> [!NOTE]
> **Note:** The Classic Edge UI is available with Edge for Private Cloud only.

To create an API proxy using the Classic Edge UI:

1. Sign in to `http://ms-ip:9000`, where <var translate="no">ms-ip</var> is the IP address or DNS name of the Management Server node.
2. Click **API Proxies** in the main window:

   ![](https://docs.apigee.com/static/api-platform/images/tutorial_new_edge_apis_menu.png)
3. Click **+ API Proxy** in the upper right:

   ![Create Proxy](https://docs.apigee.com/static/api-platform/images/tutorial_new_api_proxy_button.png)

   Apigee walks you through the process of creating a new proxy. The first decision is the
   type of proxy:

   ![](https://docs.apigee.com/static/api-platform/images/tutorial-proxy-type.png)
4. Select **Reverse proxy (most common)** , and click **Next**.

   Apigee then displays the **Details** screen.
5. Configure your proxy with the following settings:
   - **Proxy Name:** Enter "getstarted". If a proxy already exists with this name, choose a different name.
   - **Proxy Base Path:** Ensure this is set to "/getstarted".

     The Proxy Base Path is part of the URL used to make requests to your API. Edge uses the
     URL to match and route incoming requests to the proper API proxy.
   - **Existing API:** Enter "https://mocktarget.apigee.net". This defines the
     target URL that Apigee Edge invokes on a request to the API proxy.

     The mocktarget service is hosted at Apigee and returns simple data. It requires no API
     key or access token.
   - (Optional) **Description:** Enter a description for your new API proxy, such as "Getting Started proxy".

   Your proxy's details should look like the following:

   ![](https://docs.apigee.com/static/api-platform/images/getstarted-proxy-details.png)
6. Click **Next**.
7. On the **Security** screen, select **Pass through (none)** as the security option, and click **Next** :

   ![](https://docs.apigee.com/static/api-platform/images/getstarted-passthrough.png)
8. On the **Virtual Hosts** screen, accept the default selections and click **Next** .  
   ![](https://docs.apigee.com/static/api-platform/images/virtual-host-tutorial.png)
9. On the **Build** screen, make sure the **test** environment is selected next to **Deploy Environments** and click **Build and
   Deploy** :

   ![](https://docs.apigee.com/static/api-platform/images/getstarted-build-options.png)

   Apigee creates your new API proxy and deploys it to your test environment:

   ![](https://docs.apigee.com/static/api-platform/images/getstarted-proxy-done.png)
10. Click **View getstarted proxy in the editor** to display the Overview page for the API proxy:

    ![](https://docs.apigee.com/static/api-platform/images/getstarted-proxy-overview.png)

    Note that if you expand the **\[ + \]**, the UI lists both HTTP and HTTPS URLs
    for the test environment:

    ![](https://docs.apigee.com/static/api-platform/images/getstarted-proxy-urls.png)

    As a result, you can send requests to either, but this tutorial uses HTTPS.

> [!TIP]
> **Congratulations!**   
>
> You've created a simple API proxy. Next you'll test it to see how it works.

### Next step

[Step 1](https://docs.apigee.com/api-platform/get-started/create-proxy) [Step 2: Test your new proxy](https://docs.apigee.com/api-platform/get-started/test-proxy) [Step 3](https://docs.apigee.com/api-platform/get-started/change-endpoint) [Step 4](https://docs.apigee.com/api-platform/get-started/add-policy)