Start a trial

A new client gets a number of leads until an end date: two calls from your sign-up code.

A trial gives a new client a number of leads until an end date. Two calls, from your sign-up code right after creating the website.

1. How many leads and email accounts

PUT /admin/websites/set-limits/{websiteId}. Both credits and emailAccounts are required (a 405 otherwise).

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": 500,
  "emailAccounts": 2
}'

curl -X PUT "https://rest-admin.happierleads.com/admin/websites/set-limits/64b7f0a1c2d3e4f5a6b7c8d9?privateKey=YOUR_KEY" \  -H "Content-Type: application/json" \  -d '{  "credits": 500,  "emailAccounts": 2}'

Response

Press Send request to try it with sample data.

2. Trial until the end date

PUT /admin/websites/toggle-limits/{websiteId} with trialEnabled: true and the end date.

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": true,
  "trialExpireDate": "2026-11-14",
  "enableWebsiteLimits": true
}'

curl -X PUT "https://rest-admin.happierleads.com/admin/websites/toggle-limits/64b7f0a1c2d3e4f5a6b7c8d9?privateKey=YOUR_KEY" \  -H "Content-Type: application/json" \  -d '{  "trialEnabled": true,  "trialExpireDate": "2026-11-14",  "enableWebsiteLimits": true}'

Response

Press Send request to try it with sample data.