HappierleadsDocs
Full white label

Change plan or billing date

Upgrades, downgrades and a moved billing date. A normal monthly renewal needs no call.

A normal monthly renewal needs no call: on refreshOnDate the leads refill to the plan's number and the date moves on a month. Call us only when something changes.

Upgrade or downgrade

PUT /admin/websites/set-limits/{websiteId} with the new numbers.

  • Upgrade: the extra leads are added to what is left now (limit 1,000 with 377 left → 5,000 gives 4,377 left).
  • Downgrade: what is left is capped at the new number.

Try it with Mock data: the sample website has 1,000 leads a month with 377 left.

PUT/admin/websites/set-limits/{websiteId}
Try:
Request body
Website IdWebsite ID to update limits for
CreditsMaximum number of credits (leads/visitors) allowed. Set to 0 to disable tracking.
Email AccountsMaximum number of email accounts allowed for integrations. Set to 0 to disable email features.
Reset CreditsRefill what is left to the full allowance right now.
curl -X PUT "https://rest-admin.happierleads.com/admin/websites/set-limits/64b7f0a1c2d3e4f5a6b7c8d9?privateKey=YOUR_KEY" \  -H "Content-Type: application/json" \  -d '{  "credits": 5000,  "emailAccounts": 10}'
Response
Press Send request to try it with sample data.

Billing date moved, or refill now

Run both switch to paid calls again with the new date: paid mode with the new refreshOnDate, then the plan's leads with resetCredits: true.

PUT/admin/websites/toggle-limits/{websiteId}
Try:
Request body
Website IdWebsite ID
Trial EnabledEnable or disable trial mode. - `true`: Sets website to trial mode (requires `trialExpireDate`) - `false`: Clears trial mode (sets `trialEnds` to null)
Trial Expire DateWhen the trial expires. Required when `trialEnabled` is true.
Active WebsiteEnable or disable active/paid mode. - `true`: Sets website to active mode (requires `refreshOnDate`) - `false`: Clears active mode (sets `refreshOn` to null)
Refresh On DateDate when credits will automatically reset. Required when `activeWebsite` is true. Typically set to the next billing cycle date.
Enable Website LimitsEnable or disable website-level limits. - `true`: Website uses its own limits (from `limits` field) - `false`: Website uses account-level limits (unlimited at website level)
curl -X PUT "https://rest-admin.happierleads.com/admin/websites/toggle-limits/64b7f0a1c2d3e4f5a6b7c8d9?privateKey=YOUR_KEY" \  -H "Content-Type: application/json" \  -d '{  "trialEnabled": false,  "activeWebsite": true,  "enableWebsiteLimits": true,  "refreshOnDate": "2026-12-15"}'
Response
Press Send request to try it with sample data.

Next: cancel or unpaid.

On this page