Custom Proxy is different from Application Proxy. Custom Proxy applies to one creator. Application Proxy applies to the whole app. See Overview for the full picture.
Default behavior
Creators without an assigned Custom Proxy automatically use AgencyKey’s built-in Connection Servers. Protection is on out of the box — you only need to set up a Custom Proxy when you want a specific IP for a specific creator.Page layout
Table columns
| Column | Description |
|---|---|
| ID | Unique identifier (click to copy) |
| Label | Your custom name for the proxy |
| Type | HTTP or SOCKS5 |
| Host | Address and port (host:port) |
| Credentials | Username and password (hidden) |
| Creator | Assigned creator account |
| Status | Connection state |
| Actions | Edit, Duplicate, Delete |
Status indicators
| Status | Color | Meaning |
|---|---|---|
| Available | Green | Proxy is working. The detected IP address is displayed. |
| Unavailable | Red | Proxy is not responding |
| Checking… | Yellow | Check in progress |
| Not checked | Gray | Not yet tested |
Status checking is available only in the desktop application. In the web version, status shows N/A (Electron only).
Adding a proxy
- Click Add New Proxy
- Fill in the form:
| Field | Description | Required |
|---|---|---|
| Label | Your custom name for the proxy | Yes |
| Proxy Type | HTTP or SOCKS5 | Yes |
| Host | IP address or domain | Yes |
| Port | Connection port | Yes |
| Username | Login (if required) | No |
| Password | Password (if required) | No |
- Click Save
After saving, the proxy is automatically tested for connectivity. The status updates within a few seconds.
Bulk import
To add multiple proxies at once:- Click Import Proxies
- Paste one proxy per line (for example
socks5://user:pass@host:portorhost:port:login:password) - Click Import
Duplicating a proxy
To quickly create a new proxy with the same settings as an existing one:- Find the proxy in the table
- Click the copy icon in the Actions column
- A new proxy is created with the same settings
- Edit the label or any other fields as needed
Editing a proxy
- Find the proxy in the table
- Click the pencil icon in the Actions column
- Modify the necessary fields
- Click Update
Deleting a proxy
- Click the trash icon in the Actions column
- Confirm deletion
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 every proxy at once.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.Managing proxies and assigning them to creators require different permissions. A user may have access to one but not the other.
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, it shows N/A (Electron only)
- Make sure you are using the Electron app, not the web version
A creator is still using the built-in server
- 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 red, the app falls back to a built-in Connection Server automatically