Skip to main content

Reseller Setup

Setting up your reseller account takes just a few minutes. This guide walks through registration, configuration, and your first client.

Settings

Prerequisites​

  • Active Enterprise plan subscription
  • Verified email address on your CronDB account

Registration​

  1. Log into app.crondb.com
  2. Navigate to Reseller in the sidebar
  3. Click Register as Reseller
  4. Fill in your company details:
    • Company Name — Your business name (shown to clients if white-labeling is partial)
    • Contact Email — For reseller-specific communications
    • Website — Your company website
  5. Accept the Reseller Agreement
  6. Click Register

Registration is auto-approved — no waiting period. You can start adding clients immediately.

Reseller Dashboard​

After registration, the Reseller section in your sidebar shows:

  • Overview — Summary of clients, total usage, and quota allocation
  • Clients — List of all client accounts
  • API Keys — Per-client API key management
  • Usage — Detailed usage breakdown by client
  • Billing — Revenue and cost tracking

Configuration​

Quota Allocation​

Your Enterprise plan quota (999,999 queries/month) is shared across all clients. Allocate portions to each client:

SettingDescription
Default client quotaQuota applied to new clients by default
Total allocatedSum of all client quotas
UnallocatedQueries available for new clients or your own use
Overage handlingWhat happens when a client exceeds their quota

White-Label Settings​

Configure branding for your reseller presence:

  • Custom API base URL — Use your own domain (e.g., api.yourbrand.com) via CNAME
  • Custom error messages — Replace CronDB mentions with your brand
  • Custom email sender — Notifications sent from your email domain

Setting up a custom API URL:

  1. Add a CNAME record: api.yourbrand.com → reseller.crondb.com
  2. Enter your custom domain in Reseller Settings
  3. CronDB provisions an SSL certificate automatically
  4. Your clients use api.yourbrand.com instead of api.crondb.com
DNS Propagation

After adding the CNAME record, allow up to 24 hours for DNS propagation. SSL certificate provisioning happens automatically once the DNS record is verified.

Adding Your First Client​

  1. Go to Reseller → Clients
  2. Click + Add Client
  3. Enter:
    • Client Name — Their company name
    • Contact Email — Their primary contact
    • Monthly Quota — API queries allocated to this client
  4. Click Create Client
  5. Generate an API key for the client (see API Keys)

Testing Your Setup​

  1. Generate a test API key for your first client
  2. Make a test API call using the client's key:
curl -H "Authorization: Bearer cdb_client_key_here" \
  "https://api.yourbrand.com/v1/enrichment/domain?domain=example.com"
  1. Verify the response returns CronDB data
  2. Check the usage dashboard to confirm the query counted against the client's quota

Next Steps​