---
title: "Create a proxy config"
method: POST
path: "/proxies"
tags: ["Proxies"]
---

# Create a proxy config

`POST /proxies`

Creates a proxy config. The body is a discriminated union on `protocol`: `socks5` requires name, host, port, user, and password, while `wireguard` requires name and a config string. Returns the created config with its generated `proxyId`.

## Request body

- union
  - CreateSocks5Proxy
    - `name` string, required
    - `protocol` 'socks5', required
    - `host` string, required
    - `port` integer, required
    - `user` string, required
    - `password` string, required
  - CreateWireguardProxy
    - `name` string, required
    - `protocol` 'wireguard', required
    - `config` string, required

## Response `200`

Proxy created

- object
  - `success` true, required
  - `message` string, required
  - `data` union, required
    - Socks5ProxyConfig
      - `name` string, required
      - `protocol` 'socks5', required
      - `host` string, required
      - `port` integer, required
      - `user` string, required
      - `password` string, required
      - `proxyId` string, uuid, required
    - WireguardProxyConfig
      - `name` string, required
      - `protocol` 'wireguard', required
      - `config` string, required
      - `proxyId` string, uuid, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `500` — Internal Server Error

---

[API](https://skmtc.dev/droidrun/apis/droidrun-cloud.md) · [All operations](https://skmtc.dev/droidrun/apis/droidrun-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/droidrun/droidrun-cloud/revisions/a1453ac769d4/schema)