> ## Documentation Index
> Fetch the complete documentation index at: https://agencykey.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing Custom Proxies

> Add, edit, test, and assign per-creator proxies

A **Custom Proxy** is a proxy assigned to a specific creator account. Use it when you need different creators to appear from different geographic locations or have dedicated IPs.

<Note>
  Custom Proxy is different from **Application Proxy**. Custom Proxy applies only to the creator accounts you assign to it; Application Proxy is the app-wide route. See [Overview](./index) for the full picture.
</Note>

## Default behavior

A creator without a healthy assigned Custom Proxy follows the app routing order: **Your own proxy** when enabled, then a selected AgencyKey server, then **Regular connection**. Set up a Custom Proxy only when a creator needs a dedicated route.

## Page layout

### Table columns

| Column   | Description                       |
| -------- | --------------------------------- |
| ID       | Unique identifier (click to copy) |
| Name     | Your custom name for the proxy    |
| Type     | HTTP, HTTPS, or SOCKS5            |
| Host     | IP address or domain              |
| Port     | Connection port                   |
| Login    | Username, if required             |
| Password | Password, shown masked            |
| Models   | Assigned creator accounts         |
| Status   | Connection state                  |
| Actions  | Edit, Duplicate, Delete           |

### Status indicators

| Status      | Color  | Meaning                                                                         |
| ----------- | ------ | ------------------------------------------------------------------------------- |
| Available   | Green  | The latest test succeeded. Open the test result to see the detected IP address. |
| Unavailable | Red    | Proxy is not responding                                                         |
| Checking…   | Yellow | Check in progress                                                               |
| Not checked | Gray   | Not yet tested                                                                  |

<Note>
  Status checking is available only in the desktop application. In the web version, the status is unavailable.
</Note>

<Tip>
  The visible rows on the first page are automatically tested when you open Proxies in the desktop app. Other pages keep their previous status until you test them.
</Tip>

## Adding a proxy

1. Click **Add Proxy**
2. Fill in the form:

| Field      | Description                    | Required |
| ---------- | ------------------------------ | -------- |
| Label      | Your custom name for the proxy | Yes      |
| Proxy Type | HTTP, HTTPS, or SOCKS5         | Yes      |
| Host       | IP address or domain           | Yes      |
| Port       | Connection port                | Yes      |
| Username   | Login (if required)            | No       |
| Password   | Password (if required)         | No       |

<Tip>
  You can paste a full proxy string (for example `socks5://user:pass@host:port` or `host:port:login:password`) into the **Host** field — all fields are filled in automatically.
</Tip>

3. Click **Save**

<Note>
  Use **Test** to verify the proxy before saving. After it appears in the table, its status reflects the latest desktop-app check.
</Note>

## Bulk import

To add multiple proxies at once:

1. Click **Add as List**
2. Paste one proxy per line (for example `socks5://user:pass@host:port` or `host:port:login:password`)
3. Click **Import**

The valid rows are added to the table. Review the import summary for duplicates or failed rows, then test each visible page in the desktop app.

## Duplicating a proxy

To quickly create a new proxy with the same settings as an existing one:

1. Find the proxy in the table
2. Click the copy icon in the **Actions** column
3. A form opens with the same settings and a name ending in **(copy)**
4. Review the values, change the name or other fields, test the proxy, and click **Save**

## Editing a proxy

1. Find the proxy in the table
2. Click the pencil icon in the **Actions** column
3. Modify the necessary fields
4. Click **Update**

## Deleting a proxy

1. Click the trash icon in the **Actions** column
2. Confirm deletion

<Warning>
  The proxy is removed from the available list and there is no instant Undo in the interface. Reassign affected creators first; otherwise they will use the next available route in the fallback order.
</Warning>

## Testing proxies

Testing is available only in the desktop application.

### Test a single proxy

Click **Test** next to the proxy status to check if it is working.

### Check all proxies

Click **Check All** in the page header to test the proxies visible on the current page. Move to another page and run the check again when you need fresh results for the rest of the list.

### Test direct connection

Click **Test Direct** to check your network without any proxy. This helps verify your base connection.

On a successful check, the detected IP address is displayed.

## Assigning to creators

Custom Proxies are assigned on the **Accounts** page when editing a creator account. Each creator can have one Custom Proxy assigned. One proxy can be shared across multiple creators.

<Tip>
  You can also create a new proxy directly from the proxy dropdown on the Accounts page by clicking the **+** button — no need to open the Proxies page first.
</Tip>

<Note>
  Managing proxies and assigning them to creators require different permissions. A user may have access to one but not the other.
</Note>

## Troubleshooting

### Proxy shows "Unavailable"

* Verify the host and port are correct
* Check username and password
* Make sure the proxy is still active with your provider
* Try testing the proxy in another tool to isolate the issue

### Status stays "Not checked"

* Status checking works only in the desktop application
* In the browser, the status is unavailable
* Make sure you are using the desktop app, not the web version

### A creator is not using the expected route

* Open the creator on the **Accounts** page and verify the Custom Proxy is assigned
* Check the status is Available (green) on the Proxies page
* If the proxy is unavailable, the app can fall back to **Your own proxy**, a selected AgencyKey server, or **Regular connection**
* Reopen the creator tab after the proxy recovers; AgencyKey avoids switching an active OnlyFans session back to another IP immediately