> For the complete documentation index, see [llms.txt](https://developers.oxylabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.oxylabs.io/help-center/most-popular-questions/setting-up-your-first-product.md).

# Setting up your first product

This guide starts once you have an Oxylabs account.

Every product follows the same three-step pattern: get access, connect, and send your first request. Access differs slightly across products, and they're grouped below by pattern accordingly. For how the credit balance, welcome credit, and plan changes work, see [How pricing and billing work](https://developers.oxylabs.io/help-center/most-popular-questions/custom-pricing-or-a-free-trial).

### [Residential Proxies](https://developers.oxylabs.io/products/proxies/residential-proxies), [Mobile Proxies](https://developers.oxylabs.io/products/proxies/mobile-proxies), [Web Unblocker](https://developers.oxylabs.io/products/web-unblocker), and [Agent Browser](#residential-proxies-mobile-proxies-web-unblocker-and-agent-browser)

You'll get a username and password. No need to choose quantity or country when creating the instance.

1. **Get your access.** Go to the dashboard, choose the product, and select **Create instance**. You're required to name the instance before you can confirm it. Your username and password are generated as soon as you do.
2. **Connect.**

**Residential Proxies** – open the Endpoint Generator, choose a location, and set a sticky or rotating session.

**Mobile Proxies** – connect through a single endpoint. With proxies pre-checked automatically, there's no IP list to import.

**Web Unblocker** – add the single Web Unblocker endpoint to your code.

**Agent Browser** – connect your tool. Puppeteer, Playwright, CDP, and MCP clients such as Claude are all supported.

3. **Send your first request.** Add the endpoint to your script and run it. For Agent Browser, this means launching your session and starting to collect data.

<img src="https://1295635003-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpGNgdeKVOM3XvAaPheYj%2Fuploads%2FBGveoQdFoIwjfsu1Rgi3%2Funknown.png?alt=media&amp;token=ab241fec-9a61-4535-afae-fcf9ff9b60f4" alt="" height="344" width="624">

Optionally, set a spending limit for the instance during creation. This caps how much of your shared credit balance it can draw each billing cycle.

Residential Proxies and Mobile Proxies also support IP allowlisting. See [How can I whitelist IPs?](https://developers.oxylabs.io/help-center/products-and-features/how-can-i-whitelist-ips) for details.

### [ISP Proxies](https://developers.oxylabs.io/products/proxies/isp-proxies), [Dedicated ISP Proxies](https://developers.oxylabs.io/products/proxies/dedicated-isp-proxies), [Datacenter Proxies](https://developers.oxylabs.io/products/proxies/datacenter-proxies), and [Dedicated Datacenter Proxies](#residential-proxies-mobile-proxies-web-unblocker-and-agent-browser)

You'll need to choose an IP type, quantity, and country before you can access it.

1. **Get your access.** Go to the dashboard, choose the product, and select **Create instance**. You're required to set the IP type, name the instance, and enter the quantity before you can confirm it. Your username and password are generated as soon as you do. You can also set a country and, for Dedicated ISP Proxies, an ASN provider, if needed.
2. **Connect.** Use the endpoint generated from your instance.
3. **Send your first request.** Add the endpoint to your script and run it.

<img src="https://1295635003-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpGNgdeKVOM3XvAaPheYj%2Fuploads%2FMwsLrAKPHfkxErEyC4N0%2Funknown.png?alt=media&amp;token=a6186a94-ac62-4502-bb3c-73093147acf4" alt="" height="344" width="624">

<img src="https://1295635003-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpGNgdeKVOM3XvAaPheYj%2Fuploads%2Fqd1QCfnsI7a5fRl179P9%2Funknown.png?alt=media&amp;token=c2bc60f0-b26e-43ab-9485-d0d5c09e0b06" alt="" height="344" width="624">

Optionally, set a spending limit for the instance at creation. This caps how much of your shared credit balance it can draw each billing cycle.

Datacenter Proxies and Dedicated Datacenter Proxies also support IP allowlisting. See [How can I whitelist IPs?](https://developers.oxylabs.io/help-center/products-and-features/how-can-i-whitelist-ips) for how to manage this later.

### [Web API](https://developers.oxylabs.io/products/web-api)

You'll get an API key instead of a username and password.

1. **Get your access.** Go to the dashboard, choose Web API, and select **Create instance**. You're required to name the instance before you can confirm it. Your API key is generated as soon as you confirm it.
2. **Connect.** Build your request. Choose a target and location, then request raw HTML or structured JSON.
3. **Send your first request.** Run the request and get your data back.

<img src="https://1295635003-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpGNgdeKVOM3XvAaPheYj%2Fuploads%2F0O1Lnbhdo78xJ5sfLBcN%2Funknown.png?alt=media&amp;token=a8be6854-3eab-4b58-ba13-2479ac75b9ee" alt="" height="344" width="624">

***

### Prefer a guided walkthrough?

* [Follow the quick start guide](https://developers.oxylabs.io/get-started)
* [Visit the documentation](https://developers.oxylabs.io/overview)
* Or let your AI coding assistant handle setup with [Agent Skills](https://github.com/oxylabs/agent-skills)

Want to watch instead? This video covers the whole dashboard, including logging in, creating an instance, and checking status.

#### **Full dashboard overview**

{% embed url="<https://youtu.be/6piEx4Am77U>" %}

***

### Do more with your credits

Your credit balance works across every product. Add another instance anytime to try something new.

***

<a href="https://dashboard.oxylabs.io/en/" class="button primary">Head back to the dashboard</a>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://developers.oxylabs.io/help-center/most-popular-questions/setting-up-your-first-product.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.