How to add a webhook (get notified when accounts change)

For server administrators · Updated 2026-10-29

On this page
  1. Before you start
  2. Steps
  3. Test it
  4. How delivery works
  5. Good to know
  6. Common questions

A webhook makes the server tell your system what happened, so your system does not have to ask the API again and again. For each event you choose, the server sends a signed JSON POST to your address.

Before you start

  • You need the admin panel (https://<server>:2087). Resellers need the API tokens (billing systems) privilege.
  • Your system needs an HTTPS address that accepts POST requests, for example https://billing.example.com/hooks/hosting.

Steps

  1. Open Webhooks in the menu (section Account).
  2. Under Add webhook, enter the Address.
  3. Under Events, tick what to send. All account.* events are ticked to start with. See webhook events.
  4. Click Add webhook.
  5. The page shows Signing secret: with a Copy button. Store it in your system: you need it to verify the signature of each message.

Test it

Click Send test next to the webhook. A ping message is sent within a few seconds. Recent deliveries shows each message with its event, address and status: sent, pending (waiting for a retry) or failed, with the error and the number of attempts.

How delivery works

  • Messages are sent within a few seconds of the event.
  • Your address must answer with any 2xx status within 10 seconds. Redirects are not followed.
  • Otherwise the message is sent again after 1, 5, 30 and 120 minutes, then marked failed.
  • The same message can arrive twice. Use its id to ignore duplicates.
  • Deliveries are kept in the list for 30 days.

Good to know

  • The administrator's webhooks hear about every account on the server, and about server events such as failed tasks. A reseller's webhooks hear only about the reseller's own accounts.
  • A reseller's address must be on the public internet; addresses of this server or private networks are refused.
  • Up to 20 webhooks each. Click Show secret to see a webhook's secret again, or Remove to delete it.
  • To change the events of a webhook, add a new one and remove the old one.

Common questions

Why do I get "Enter the full address, starting with https://"?

The address must start with http:// or https:// and have a host name, without a user name or password in it.

Why do I get "The name … does not resolve."?

The host name of your address has no DNS record yet. Create it, or use the IP address.

Was this article helpful?

Still stuck?

Ask the AI about your exact situation — it answers from this knowledge base — or contact us.