> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Smartproxy

> Smartproxy (now Decodo) offers a comprehensive suite of proxy and web scraping solutions, providing users with access to a vast network of residential, datacenter, ISP, and mobile proxies, along with scraping APIs for efficient data collection.

![Smartproxy logo](https://mintcdn.com/composio-preview/B09iGux45A5cYDuO/images/toolkits/smartproxy.svg?fit=max\&auto=format\&n=B09iGux45A5cYDuO\&q=85\&s=5d40c54999493d28828a3a567fe196ed)

* **Category:** web scraping & browser
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 6
* **Triggers:** 0
* **Slug:** `SMARTPROXY`
* **Version:** 20261101\_00

## Tools

> [accordion] Delete Whitelisted IP
>
> **Slug:** `SMARTPROXY_DELETE_WHITELISTED_IP`
>
> Tool to delete a specified whitelisted IP by its ID. Use when you need to remove an IP address from the whitelist. Returns success confirmation on completion.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> The ID of the whitelisted IP to delete. You can retrieve available IDs using the Get Whitelisted IPs action.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Generate Back Connect Endpoints
>
> **Slug:** `SMARTPROXY_GENERATE_BACKCONNECT_ENDPOINTS`
>
> Tool to generate custom back connect endpoints for Residential subscription proxies. Use when you need to create proxy connection strings with specific configuration parameters like session type, location, and authentication credentials.
>
> #### Input Parameters
>
> **ip** `string`
>
> IP address to be used instead of domain. Required if domain is 'ip'. Must contain port at the end (e.g., '1.1.1.1:7000').
>
> **city** `string`
>
> Full city name in lowercase with underscore instead of space (e.g., 'new\_orleans').
>
> **page** `integer`
>
> Page number for pagination of routes. Minimum value is 1. Default is 1.
>
> **count** `integer`
>
> Count of routes that will be generated and returned. Minimum value is 1. Default is 10.
>
> **state** `string`
>
> State selection if country is USA ('us'). Provide full state name with underscore instead of space (e.g., 'new\_york').
>
> **domain** `string`
>
> Domain to be used for routes. Default is 'gate.decodo.com'. Use 'ip' to specify an IP address instead.
>
> **country** `string`
>
> Country Alpha2 code in lower case (e.g., 'us', 'gb').
>
> **password** `string` *required*
>
> Password for authorization. This parameter is required.
>
> **protocol** `string ("http" | "https")`
>
> Protocol to be used for proxy connections. Default is 'http'.
>
> **username** `string` *required*
>
> Username for authorization. This parameter is required.
>
> **line\_break** `string ("\\n" | "\\r\\n" | "\\r" | "\\t")`
>
> Line break type for text responses.
>
> **session\_time** `integer`
>
> Session time in minutes, range is 1-1440 (inclusive). This parameter is required if session\_type is 'sticky'. Default is 10.
>
> **session\_type** `string ("sticky" | "random")`
>
> Session type to use. Choose 'sticky' for sticky sessions or 'random' for rotating sessions. Default is 'sticky'.
>
> **output\_format** `string ("protocol:auth@endpoint" | "endpoint:auth" | "auth@endpoint")`
>
> Output format type. Default is 'protocol:auth\@endpoint'.
>
> **response\_format** `string ("json" | "txt" | "html")`
>
> Response type that will be returned. Can be 'json', 'txt', or 'html'. Default is 'json'.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Generate Custom Endpoints
>
> **Slug:** `SMARTPROXY_GENERATE_CUSTOM_ENDPOINTS`
>
> Tool to generate custom proxy endpoints for Residential and Datacenter Pay per GB subscriptions. Use when you need to create configured proxy endpoints with specific authentication, session, and location parameters.
>
> #### Input Parameters
>
> **ip** `string`
>
> IP address to use instead of domain. REQUIRED when domain is 'ip'.
>
> **page** `integer`
>
> Pagination page number (minimum 1). Maximum depends on count and location. Default is 1.
>
> **count** `integer`
>
> Number of routes to generate (minimum 1). Maximum depends on page and location. Default is 10.
>
> **domain** `string`
>
> Domain for proxy routes. Use 'ip' to use IP address instead of domain. Default is 'decodo.com'.
>
> **location** `string`
>
> Geographic location: country Alpha-2 code, city, or state name in lowercase. Use 'random' for any location. Default is 'random'.
>
> **password** `string`
>
> Password for authorization. REQUIRED when auth\_type is 'basic'.
>
> **username** `string`
>
> Username for authorization. REQUIRED when auth\_type is 'basic'.
>
> **auth\_type** `string ("basic" | "whitelist")`
>
> Authentication method for proxy endpoints.
>
> **line\_break** `string ("\\n" | "\\r\\n" | "\\r" | "\\t")`
>
> Line break types for text responses.
>
> **proxy\_type** `string`
>
> Proxy type for route generation. Default and only option is 'residential\_proxies'.
>
> **session\_time** `integer`
>
> Session duration in minutes (1-1440 inclusive). REQUIRED when proxy\_type is 'residential\_proxies', auth\_type is 'basic', and session\_type is 'sticky'. Default is 10.
>
> **session\_type** `string ("sticky" | "random")`
>
> Session type for proxy connections.
>
> **output\_format** `string ("protocol:auth@endpoint" | "endpoint:auth" | "auth@endpoint")`
>
> Output format for generated proxy endpoints.
>
> **response\_format** `string ("json" | "txt" | "html")`
>
> Response format type.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get API Key
>
> **Slug:** `SMARTPROXY_GET_API_KEY`
>
> Tool to instruct how to obtain Smartproxy API key. Use when you need to authenticate API requests but don't have your key (manual dashboard process).
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Endpoints By Type
>
> **Slug:** `SMARTPROXY_GET_ENDPOINTS_BY_TYPE`
>
> Tool to retrieve proxy endpoints by type (random or sticky) for Residential subscription. Returns location, hostname, and port\_range for each endpoint. Use when you need specific endpoint configuration for a particular proxy type.
>
> #### Input Parameters
>
> **type** `string ("random" | "sticky")` *required*
>
> Type of proxy endpoint to retrieve. 'random' returns endpoints with rotating IPs, 'sticky' returns endpoints with session-based IPs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Endpoints and Ports
>
> **Slug:** `SMARTPROXY_LIST_ENDPOINTS_AND_PORTS`
>
> Retrieve available endpoint types for a Residential subscription, including their available location counts and relative URLs.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
