**Version: 202601**

# Create app proxy

**POST** `/openapi/2026-01/app-proxies`

Creates an app proxy that maps a storefront access path to the developer's application URL.

## Request

**application/json**

**Body | Example**

**Body (required)**

- `real_path` string (required)

  URL path used to access Shoplazza. For example, use "pay" when the target path is "apps/pay"
- `proxy_url` string (required)

  URL of the developer's application that processes requests, for example, "[http://www.example.com](http://www.example.com)"
- `change_origin` boolean

  Whether to rewrite the request Host header to the proxy target

```json
{
  "real_path": "string",
  "proxy_url": "string",
  "change_origin": true
}
```

## Responses

**200**

OK

**application/json**

**Schema | Example**

**Schema**

- `code` string

  error code
- `message` string

  error message
- `data` object

  - `app_proxy` object

    Created app proxy

    - `id` int32

      Unique identifier of the app proxy
    - `real_path` string

      URL path configured for accessing the proxy. For example, use "pay" when the target path is "apps/pay"
    - `proxy_url` string

      URL of the developer's application that processes proxied requests, for example, "[http://www.example.com/app](http://www.example.com/app)"
    - `change_origin` boolean

      Whether to rewrite the request Host header to the proxy target
    - `created_at` string

      Timestamp when the app proxy was created
    - `updated_at` string

      Timestamp when the app proxy was last updated

```json
{
  "code": "string",
  "message": "string",
  "data": {
    "app_proxy": {
      "id": 0,
      "real_path": "string",
      "proxy_url": "string",
      "change_origin": true,
      "created_at": "string",
      "updated_at": "string"
    }
  }
}
```