# Proxy

{% hint style="info" %}
Our current support is limited to unauthenticated HTTP Proxies. When your app makes HTTPS connections, the data remains encrypted despite the unencrypted connection to the proxy. The app sends a CONNECT request to the proxy for the destination HTTPS server, initiating an SSL handshake. The proxy acts as a TCP connection forwarder, ensuring end-to-end encryption for app data.<br>

If you need to allow-list specific IPs for proxy access, you can use our [IP Blocks endpoint](https://docs.appetize.io/rest-api/ip-blocks) to retrieve the necessary IP ranges.
{% endhint %}

## App Level Proxy

Appetize supports settings a proxy server on a per-app basis.

{% hint style="warning" %}
App-Level proxy settings will override the Account **`default proxy`**. if you *always* want the Account-level proxy to be used, use **`forced proxy`** instead.
{% endhint %}

To allow Appetize to proxy all the network events, you need to specify a proxy server to route network traffic to:

### With Query Parameter

Add the `proxy` query parameter to your app or embed URL with your URL encoded proxy server's address (e.g. `http://example.com:8080/`)as value.

```uri
&proxy=http%3A%2F%2Fexample.com%3A8080%2F
```

See [Query Params Reference](https://docs.appetize.io/platform/query-params-reference#proxy) for more information.

### With JavaScript SDK

Set `proxy` to `http://example.com:8080/` in the configuration e.g.

```typescript
await client.setConfig({
    proxy: "http://example.com:8080",
    ...
})
```

See [Configuration](https://docs.appetize.io/javascript-sdk/configuration#proxy) for more information.

## Organization Level Proxy

{% hint style="info" %}
Organization Level Proxy is only available on our Premium and Enterprise plans. [Contact us](https://appetize.io/contact-us) to learn more.
{% endhint %}

You may also set organization-wide proxy settings by navigating to [**Organization** **->** **Proxy settings**](https://appetize.io/organization/proxy-settings).

### Default Proxy

By setting a default proxy, the proxy will be used when no other proxy is specified.

<figure><img src="https://2147444700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJUveBCJfn0GR8-hlqi%2Fuploads%2F93v15rzVGsvcftZ0MrsK%2FScreenshot%202025-03-21%20114319.png?alt=media&#x26;token=d8ea390f-b045-49fd-8a70-c6a016827c1a" alt=""><figcaption><p>Example default proxy</p></figcaption></figure>

### Forced Proxy

By setting a forced proxy, the proxy will be used regardless of other proxy settings.

<figure><img src="https://2147444700-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MJUveBCJfn0GR8-hlqi%2Fuploads%2FLBrCuFrTmht3sVpdqeWi%2FScreenshot%202025-03-21%20114342.png?alt=media&#x26;token=2a6c083f-f6ab-425d-8204-f31ef5ee727c" alt=""><figcaption><p>Example forced proxy</p></figcaption></figure>