> For the complete documentation index, see [llms.txt](https://docs.incogniton.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.incogniton.com/proxy-management/integrating-proxies.md).

# Attach external proxy

If you have an existing proxy subscription from an external provider, you can connect those proxies directly to Incogniton. This page covers both ways to do it: adding a single proxy and adding multiple proxies at once.

### Add a single proxy

Open **Proxy Library** from the left-side menu and click **+ New proxy** in the top right. This opens the Add proxy form. If you need to add multiple proxies at once, there is a bulk add option covered in the next section.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FH8yXxFJjKNEduZ4cdtjg%2Fuploads%2F5Wof9uNTkvYYqtxyxQK6%2Fadd-proxy.mp4?alt=media&token=3da25719-58ac-45d1-aca0-17301a192833>" %}

{% stepper %}
{% step %}

#### Enter proxy details

Give the proxy an optional display name, then select your Connection type — **HTTPS** or **SOCKS5** depending on what your provider supports. Enter the proxy address in the **Proxy (ip:port)** field, followed by your **Proxy username** and **Proxy password**.

You can also paste the full credentials string directly into the **ip:port** field using the format `ip:port:username:password` and Incogniton will populate the remaining fields automatically.
{% endstep %}

{% step %}

#### Configure group and proxy provider

Use the **Group** dropdown to organise the proxy into an existing group, or leave it as **Unassigned**.

The **Proxy provider** dropdown controls which database Incogniton uses to validate the proxy's geolocation. **Main provider** uses IPstack by default. If a proxy validates against the wrong location due to a vendor data issue or a database error, switch to **Backup provider** or **Second backup provider** to re-validate the same proxy against a different source.

Optionally, add any reference notes in the **Notes** field.
{% endstep %}

{% step %}

#### Enable rotating proxy (optional)

If your provider supports proxy rotation via an API, toggle on **Rotating proxy** and enter your provider's **Proxy rotation API url**. Incogniton will call this URL to get a new IP when a rotation is triggered.
{% endstep %}

{% step %}

#### Check and Add proxy

Click **Check** to verify the connection. If you want to stage multiple proxies before saving, click **Add to list** to queue this proxy and continue adding more. Once you are done, click **Add** to save the proxy to your library.
{% endstep %}
{% endstepper %}

### Add bulk proxies

If you have a list of proxies to add at once, use the bulk add option instead. From the Add proxy form, click **Bulk add** at the bottom left.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FH8yXxFJjKNEduZ4cdtjg%2Fuploads%2Fl7MC9yv6oHAvJmbUBuB9%2Fadd-bulk-proxy.mp4?alt=media&token=710ff058-6e9d-430f-97f5-cc9932930ed9>" %}

{% stepper %}
{% step %}

#### Paste your proxies

Paste your proxy list into the text field, one proxy per line, using the format `ip:port:username:password`. You can load your proxy list from a CSV file by selecting **Load from file** and choosing your file. Each row in the CSV should follow the same format.
{% endstep %}

{% step %}

#### Assign a group

Use the **Group** dropdown to assign all imported proxies to a group, or leave them as Unassigned.
{% endstep %}

{% step %}

#### Add the proxies

Click **Add** to save all proxies to your Library at once.
{% endstep %}
{% endstepper %}

Once added, your proxies appear in the **Proxy Library** under the **All Proxies** tab. From there you can assign them to profiles, organise them into groups, and manage them without re-entering credentials.

To assign a proxy to a profile, open the profile editor, go to the **Proxy** tab, select **Proxy Library**, and click **Select from Proxy Library**.