Embed Happierleads screens
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.