Authorized Domains | ZeroBot Docs

What Are Authorized Domains?

Authorized Domains is a mandatory security layer that ensures only your own domains can communicate with the ZeroBot API using your license key.

Before you can deploy the ZeroBot script on any website, you must first register that domain in your dashboard. Without authorization, the API will reject all requests from that domain with an Unauthorized Domain error.

This prevents unauthorized third parties from using your license key on their own domains, protecting both your account and your API quota.

Why Is This Required?

Domain authorization serves three critical purposes:

Prevents API Abuse

Blocks anyone who obtains your license key from using it on unauthorized domains, protecting your API quota.

Ownership Verification

Ensures only domains you explicitly approve can access ZeroBot services under your account.

Secures Configuration

Your custom rules, captcha settings, and antibot configuration are only applied to your authorized domains.

Step-by-Step

How to Authorize a Domain

1

Open the My Domains page

Log into your ZeroBot Dashboard and click My Domains in the sidebar under Antibot Setup.

2

Enter your domain

Type the domain name where you will deploy ZeroBot. Use the root domain only — do not include subdomains, paths, or protocol:

example.com          (correct)
www.example.com      (not needed)
test.example.com     (not needed)
https://example.com  (incorrect)

3

Click "Authorize Domain"

The domain will be added to your authorized list immediately. You can now deploy the ZeroBot script on that domain.

Done! Once authorized, all subdomains under that root domain are automatically covered. For example, authorizing example.com also covers shop.example.com, api.example.com, etc.

Domain Limits

Each subscription plan includes a specific number of authorized domain slots. The default limit is 5 domains per account.

You can see how many domain slots remain on the My Domains page in your dashboard. The remaining count updates automatically as you add or remove domains.

Action	Effect on Quota
Add a domain	Remaining slots decrease by 1
Delete a domain	Remaining slots increase by 1

Need more domain slots? Contact @brendonurie2000 to request an increase based on your subscription.

How It Works

Here's what happens when a visitor hits your ZeroBot-protected page:

1

Script sends request to ZeroBot API

The ZeroBot script on your server sends the visitor's data along with your license key and the current domain to the API.

2

API checks domain authorization

The API verifies that the domain is in your authorized domains list. If the domain is not authorized, the API immediately returns:

{ "query": "failed", "reason": "Unauthorized Domain : example.com" }

3

If authorized, bot detection proceeds

Once the domain is verified, ZeroBot runs its full detection engine (IP analysis, fingerprinting, VPN/datacenter checks, etc.) and returns the result.

Important: If you see Unauthorized Domain on your page, it means you forgot to add the domain to your dashboard. Go to My Domains and authorize it.

Managing Your Domains

From the My Domains page, you can:

Add domains — Authorize new domains where you'll deploy ZeroBot.
View domains — See all your currently authorized domains, their status, and creation date.
Remove domains — Click Delete to remove a domain. This frees up a slot but immediately blocks that domain from using your license key.

Caution: Removing a domain will instantly stop ZeroBot protection on that domain. Any live ZeroBot script on that domain will start showing Unauthorized Domain errors.

Common Issues

Error	Cause	Solution
`Unauthorized Domain`	Domain not added to authorized list	Go to My Domains and add your domain
`Invalid License`	License key is wrong or expired	Check your license key in Profile settings
Domain limit reached	You've used all your domain slots	Remove unused domains or contact support for more slots

Thank You

Thank you for using ZeroBot. Domain authorization is a critical security measure that protects your account and ensures only your websites benefit from ZeroBot's protection.

Need help? Contact our support team anytime through Telegram or our dashboard chat.