# ResellerHQ > ResellerHQ is a white-label reseller platform for phone numbers, domains and Google mailboxes: one prepaid wallet, one dashboard and one API, with your brand and your price in front of your customers. ## Products ### Phone numbers (Open in the dashboard) Private numbers that receive SMS, for any service or locked to one. - Rent from 12 hours to a year - Messages by inbox, API or signed webhook - Renew automatically or cancel for a refund ### Domains (Open in the sandbox) Registration and renewal across the endings your customers ask for. - Search one name across every ending at once - Register and renew from your wallet - One API call, safe to retry ### Google mailboxes (Open in the dashboard) Whole Google mailboxes on your customers' domains, set up for them: the account, the mail DNS and two-step verification. - Up to 10 mailboxes per domain, billed monthly - Sign in with OAuth or an app password over IMAP - Mail DNS (MX, SPF, DKIM and DMARC) set for you ## How it works 1. **Open an account.** Sign up with an email address. Your reseller account and a sandbox to test in are created in the same step. 2. **Fund your wallet.** The wallet is prepaid. An order reserves what it needs, charges only for what is delivered, and returns the rest. 3. **Place an order.** Choose a product in the dashboard, or send one POST request. You see the wholesale price before you commit. 4. **Sell it as yours.** Set your own price and deliver under your own brand. Events reach your systems as signed webhooks, so your customers never see us. ## Platform - **A wallet you can audit.** Every movement of money is a double-entry journal line. Funds are held before a purchase and captured only for what was delivered, so a failed order costs nothing. - **Several providers behind one price.** Each order is routed to the cheapest upstream provider that can fulfil it and falls through to the next if one cannot. You see one price, and it does not change with the provider. - **Safe to retry.** Send an Idempotency-Key with a purchase and a retried request returns the original result instead of buying twice. The same rule protects renewals and cancellations. - **Signed webhooks.** Events follow the Standard Webhooks specification: an HMAC-SHA256 signature, a timestamp and automatic retries with backoff. Verify them with any Standard Webhooks library. - **Renewals that look after themselves.** Turn on auto-renew and what you sell is extended shortly before it ends. If the wallet is short you are told once, and it lapses on time instead of failing silently. - **A sandbox that behaves like production.** Test accounts run against a built-in provider. Place orders with test funds, trigger test events and exercise your webhook handler before spending anything. ## API - Base URL: https://app.resellerhq.com/api/v1 - Authentication: `Authorization: Bearer ` - Amounts are integers in US cents. - OpenAPI 3.1 document: https://app.resellerhq.com/api/openapi.json - Purchases, renewals and cancellations accept an `Idempotency-Key` header. - A Model Context Protocol server at https://app.resellerhq.com/api/mcp lets an AI assistant read an account directly, over Streamable HTTP (protocol revision `2026-07-28`), with the same API key as a bearer token: [Use ResellerHQ from your AI assistant](https://app.resellerhq.com/docs/mcp). ```sh curl -X POST https://app.resellerhq.com/api/v1/numbers/orders \ -H "Authorization: Bearer $RHQ_API_KEY" \ -H "Idempotency-Key: $(uuidgen)" \ -H "Content-Type: application/json" \ -d '{"country":"US","duration":"30d","customerId":"CUSTOMER_ID"}' ``` ## Frequently asked questions ### What is ResellerHQ? ResellerHQ is a white-label reseller platform for phone numbers, domains and Google mailboxes. You buy at wholesale from one prepaid wallet, through a dashboard or a REST API, and sell to your own customers under your brand at a price you choose. ### Who is it for? It is for agencies, SaaS companies and independent resellers who already have customers and want to sell them infrastructure without negotiating with carriers, registrars and email providers, or building billing, routing and delivery themselves. ### What can I resell? Three product lines: United States phone numbers that receive SMS, domains across many endings, and whole Google mailboxes set up on your customers’ domains. All three are open in the sandbox; live ordering is opening account by account. The platform is in early access. ### How does pricing work? You pay a wholesale price that is shown before you buy, in the dashboard and from the offers endpoint of the API. You decide what to charge your own customers, and the difference is your margin. ### When is my wallet charged? When you place an order, the total is reserved in your wallet. You are charged only for what is actually delivered; anything reserved for items that could not be delivered is returned automatically. ### Will my customers know I use ResellerHQ? No. You sell under your own brand and at your own price. Orders are placed through your account, and events are delivered to your own systems by webhook, so your product is what your customers see. ### Is there an API? Yes. Everything the dashboard does goes through a public REST API described by an OpenAPI 3.1 document. Amounts are integers in US cents, purchases accept an Idempotency-Key, and events are sent as signed webhooks. ### Can I try it before paying? Yes. Every account starts in a sandbox with a built-in test provider. You can add test funds, place orders and trigger test events without a card and without buying anything real. ### What happens if an order cannot be fulfilled? The order is tried with the next upstream provider. If none can fulfil it, the order fails, the money reserved for it is returned to your wallet, and you are not charged. ### What is acceptable use? Everything bought through the platform must be used lawfully and in line with the terms of the services it is used with. Accounts used for fraud, spam or impersonation are suspended. ## Links - [Home](https://app.resellerhq.com/) - [Docs](https://app.resellerhq.com/docs) - [API reference](https://app.resellerhq.com/docs/api) - [OpenAPI document](https://app.resellerhq.com/api/openapi.json) - [Create an account](https://app.resellerhq.com/signup) ## Product pages - [Phone numbers](https://app.resellerhq.com/products/phone-numbers.mdx): Private numbers your customers can rent by the hour or the year - [Domains](https://app.resellerhq.com/products/domains.mdx): Domain registration under your brand, from search to renewal - [Google mailboxes](https://app.resellerhq.com/products/mailboxes.mdx): Whole Google mailboxes for your customers, set up and ready to sign in ## Docs Every page below is Markdown. All of them in one file, with the API reference: https://app.resellerhq.com/llms-full.txt - [Activity log](https://app.resellerhq.com/docs/activity.mdx): Every change made in your account, with who made it, when, and from where - in the dashboard and over the API. - [For coding agents](https://app.resellerhq.com/docs/agents.mdx): Machine-readable descriptions of ResellerHQ, and a prompt to hand to a coding agent. - [Authentication](https://app.resellerhq.com/docs/authentication.mdx): Authenticate with a bearer API key. The key also decides whether you reach the sandbox or the live side. - [Use ResellerHQ in ChatGPT or Codex](https://app.resellerhq.com/docs/chatgpt.mdx): Once ResellerHQ is listed in OpenAI's app directory, connect it with one sign-in and ask ChatGPT or Codex about your wallet, domains, numbers, customers and invoices - never to buy, register, renew or top anything up. - [Customer pricing](https://app.resellerhq.com/docs/customer-pricing.mdx): Price lists set what each of your customers pays on top of the wholesale price, with volume tiers, contract prices for one customer, prices fixed on single items, and lists in other currencies. - [DNS](https://app.resellerhq.com/docs/dns.mdx): Host a domain's DNS with us: turn the zone on, keep its records, and know how long a change takes to be seen. - [Domains](https://app.resellerhq.com/docs/domains.mdx): Search a name across every ending on offer, register it, renew it, and see it through to the end of its life. - [Errors](https://app.resellerhq.com/docs/errors.mdx): The shape of an error response, and what each status code means. - [Idempotency](https://app.resellerhq.com/docs/idempotency.mdx): Send an Idempotency-Key so a retried request can never buy twice. - [Introduction](https://app.resellerhq.com/docs.mdx): What ResellerHQ is, what you can resell through it, and where to start. - [Invoicing](https://app.resellerhq.com/docs/invoicing.mdx): Bill a customer for sales you have already made, discount an invoice before it is issued, correct one already sent with a void or a credit note, and record payments, refunds and statements against their balance. - [Mailbox licences (retired)](https://app.resellerhq.com/docs/mailbox-licences.mdx): Licences are no longer sold. What still works for a licence you already hold. - [Mailboxes](https://app.resellerhq.com/docs/mailboxes.mdx): Order Google mailboxes on a domain in one call, and sign in with OAuth or an app password. - [Use ResellerHQ from your AI assistant](https://app.resellerhq.com/docs/mcp.mdx): Connect Claude, Cursor or another MCP client to your account with an API key, and ask it to read your wallet, customers, domains, numbers, mailboxes and sales - or, with a buying key, to order and invoice with a confirmation step in front of every purchase. - [Phone numbers](https://app.resellerhq.com/docs/numbers.mdx): Rent private numbers that receive SMS, read their messages, and renew or cancel them. - [Quickstart](https://app.resellerhq.com/docs/quickstart.mdx): Create a sandbox key, add test funds, order a phone number and read its first message. - [Sandbox and live](https://app.resellerhq.com/docs/sandbox-and-live.mdx): Every account has a sandbox and a live side. They have separate wallets, data and API keys. - [Signing in](https://app.resellerhq.com/docs/signing-in.mdx): A password, a provider or a passkey - and what a passkey is if you have never used one. - [Team and roles](https://app.resellerhq.com/docs/team.mdx): Invite colleagues with their own logins, each with a role that controls what they can do. - [Wallet](https://app.resellerhq.com/docs/wallet.mdx): The prepaid wallet reserves money for an order, charges for what is delivered, and returns the rest. - [Webhooks](https://app.resellerhq.com/docs/webhooks.mdx): Receive signed events on your own endpoint, following the Standard Webhooks specification. - [API reference](https://app.resellerhq.com/docs/api.mdx): 174 operations, each Markdown at its own URL ## Articles Guides and comparisons. Each cites its sources and is Markdown at the link. - [Holding a domain portfolio: renewals, status codes and the names that attack yours](https://app.resellerhq.com/blog/holding-a-domain-portfolio.mdx): Holding more than a few domains means missed renewals, EPP status codes on failed transfers, and lookalike names registered against your brand. - [How SPF, DKIM and DMARC work together, and what to do when one fails](https://app.resellerhq.com/blog/how-spf-dkim-and-dmarc-work-together.mdx): SPF checks who may send, DKIM checks the message was not altered, and DMARC ties the two together and tells a receiver what to do on failure. Fix SPF first, then DKIM by provider, then move DMARC to enforcement. - [Pricing what you resell: cost, markup, margin and the invoice at the end of it](https://app.resellerhq.com/blog/pricing-what-you-resell-cost-markup-and-margin.mdx): Pricing what you resell as eight sums: one sale's margin, Workspace vs 365 seat cost, break-even, MRR/ARR and lifetime value, each by free calculator. - [Sending SMS that arrives: segments, sender names and A2P registration](https://app.resellerhq.com/blog/sending-sms-that-arrives.mdx): An SMS fails for one of three reasons: too many segments, a blocked sender name, or no A2P 10DLC registration. One guide, with a calculator for each. - [The DNS records a domain needs, and what each one actually does](https://app.resellerhq.com/blog/the-dns-records-a-domain-needs.mdx): A domain's own DNS mostly comes down to five record types: TXT, MX, CNAME, CAA, and the NS/SOA pair every zone carries. This guide explains what each one does, with a live checker for every claim. - [Verifying one of our webhooks: signatures, retries and every error, with our own API](https://app.resellerhq.com/blog/verifying-one-of-our-webhooks.mdx): Recompute our webhook signature in bash, Python and Node, generate test secrets and keys, read every documented error code, and decode a ULID, against our exact API. - [What Google and Yahoo require from bulk senders, and how to prove you meet it](https://app.resellerhq.com/blog/what-google-and-yahoo-require-from-bulk-senders.mdx): Google and Yahoo both require SPF, DKIM, DMARC, forward/reverse DNS and under 0.3% spam complaints. The '5,000 a day' rule is Google's, not Yahoo's. - [Can AI agents order through a reseller API?](https://app.resellerhq.com/blog/can-ai-agents-order-through-a-reseller-api.mdx): Can AI agents order through a reseller API? Yes, if the API publishes an OpenAPI document, idempotency keys, a sandbox key and signed webhooks for events. - [How to change subscription seat counts without double-charging a customer](https://app.resellerhq.com/blog/idempotent-seat-changes-for-mailbox-licences.mdx): How to change subscription seat counts without double-charging a customer: retry the exact seat total and read the 409 error naming the unresolved change. - [How to invoice your reseller customers](https://app.resellerhq.com/blog/how-to-invoice-your-reseller-customers.mdx): What a reseller invoice must show, invoicing each sale versus running one bill a month, keeping wholesale cost off the page, and chasing what is overdue. - [How to price reseller services: markup, price lists and customer-specific rates](https://app.resellerhq.com/blog/how-to-price-reseller-services-markup-and-price-lists.mdx): How to price reseller services: set a markup on wholesale cost, choose a price list or an agreed price, and change prices without surprising a customer. - [How to register domains in bulk through an API](https://app.resellerhq.com/blog/how-to-register-domains-in-bulk-through-an-api.mdx): Register domains in bulk through an API by checking an exact list first, then sending one idempotent request per domain. The safe workflow, and its limits. - [How to test a reseller API integration in a sandbox](https://app.resellerhq.com/blog/how-to-test-a-reseller-api-integration-in-a-sandbox.mdx): A sandbox proves your code handles a completed order, a failed one, a retried request and a signed webhook. The test plan, and where live still differs. - [Multi-provider failover routing for a reseller API](https://app.resellerhq.com/blog/multi-provider-failover-routing-for-reseller-apis.mdx): Multi-provider failover routing for a reseller API tries the cheapest upstream first and falls through on a clear decline, never on an unclear one. - [What happens when you can't pay for a renewal as a reseller](https://app.resellerhq.com/blog/how-renewals-and-grace-periods-work-for-resellers.mdx): Numbers, mailboxes and domains each fail a renewal differently: one event and no grace period, three days before deletion, or daily retries until the domain expires. - [Cold email infrastructure: how many domains and mailboxes you need](https://app.resellerhq.com/blog/cold-email-infrastructure-domains-and-mailboxes.mdx): Vendor guidance implies 20 to 100 mailboxes on 2 to 17 domains per 1,000 cold emails a day. Gmail and Yahoo require spam complaint rates below 0.3%. - [Domain reseller APIs compared: what developers should check](https://app.resellerhq.com/blog/domain-reseller-api-comparison.mdx): Domain reseller APIs differ most in retry safety, webhooks, rate limits and test environments, not in REST versus XML. Here is what each one documents. - [Google Workspace vs Microsoft 365: which is better to resell?](https://app.resellerhq.com/blog/google-workspace-vs-microsoft-365-for-resellers.mdx): Microsoft 365 is easier to start reselling and publishes its rules; Google Workspace has simpler terms and API, but a contract with Google comes first. - [How to become a Google Workspace reseller in 2026](https://app.resellerhq.com/blog/how-to-become-a-google-workspace-reseller.mdx): To resell Google Workspace you need a signed Google reseller contract, or a distributor or wholesale platform that holds one. Steps, prices and terms. - [How to start a domain and email reselling business](https://app.resellerhq.com/blog/how-to-start-a-domain-and-email-reselling-business.mdx): Open a wholesale domain account, add Google Workspace or Microsoft 365 through a distributor, price for renewals, and earn your margin on service. - [Idempotency keys and signed webhooks: the two things a reseller API must get right](https://app.resellerhq.com/blog/idempotency-keys-and-webhooks-for-reseller-apis.mdx): An idempotency key makes a retried purchase safe and a signed webhook makes an event trustworthy. Here is what the specs say and how to check a provider. - [Phone number APIs for receiving SMS, compared](https://app.resellerhq.com/blog/phone-number-apis-for-receiving-sms.mdx): US list prices on 7 October 2026: Plivo has the cheapest local number at $0.50 a month and Telnyx the cheapest inbound SMS at $0.004 per message part. - [Prepaid wallet billing for a reseller platform: holds, captures and a double-entry ledger](https://app.resellerhq.com/blog/prepaid-wallet-billing-for-resellers.mdx): A reseller wallet should reserve funds with a hold, capture only what is delivered, release the rest, and record every step in a double-entry ledger. - [ResellerClub alternatives in 2026, compared](https://app.resellerhq.com/blog/resellerclub-alternatives.mdx): Six ResellerClub alternatives compared on pricing model, API, sandbox, white-label and payment terms, using each vendor's own pages as read in October 2026. - [Reselling Microsoft 365: a plain guide to CSP in 2026](https://app.resellerhq.com/blog/microsoft-365-csp-reseller-guide.mdx): New Microsoft 365 resellers join CSP as indirect resellers through a distributor; direct bill needs 12 months of history and USD 1 million in CSP revenue. - [Twilio alternatives for reselling phone numbers](https://app.resellerhq.com/blog/twilio-alternatives-for-reselling-phone-numbers.mdx): Telnyx, Plivo, Sinch, Vonage and Bandwidth all separate numbers per customer. Only Telnyx and Vonage document customer balances; none publish reseller margins. - [What is a white-label reseller platform?](https://app.resellerhq.com/blog/what-is-a-white-label-reseller-platform.mdx): A white-label reseller platform lets you buy domains, mailbox licences or phone numbers at wholesale and sell them under your own brand and price. ## Free tools 112 free tools in 7 families; each tool is Markdown at its own URL with .mdx added. - [Email authentication](https://app.resellerhq.com/tools/email-authentication): Check and build the SPF, DKIM and DMARC records that decide whether mail arrives. (22 tools) - [DNS](https://app.resellerhq.com/tools/dns): Read what a domain is really publishing, and build the records a provider asks for. (27 tools) - [Domains](https://app.resellerhq.com/tools/domains): See whether a name is free, who holds it, and what the registry says about it. (12 tools) - [Deliverability](https://app.resellerhq.com/tools/deliverability): Meet the rules the big mailbox providers set before they start rejecting your mail. (14 tools) - [For developers](https://app.resellerhq.com/tools/developers): Try a webhook, a key or an API call without writing a script to do it first. (10 tools) - [Messaging](https://app.resellerhq.com/tools/messaging): Work out what a text message really costs to send. (10 tools) - [Pricing and billing](https://app.resellerhq.com/tools/pricing): Work out what to charge, what it leaves you, and what a change mid-cycle costs. (17 tools)